From mboxrd@z Thu Jan 1 00:00:00 1970 X-GM-THRID: 7003273629391650816 X-Received: by 2002:a05:6402:714:: with SMTP id w20mr2741251edx.62.1630576724369; Thu, 02 Sep 2021 02:58:44 -0700 (PDT) X-BeenThere: isar-users@googlegroups.com Received: by 2002:a17:907:361:: with SMTP id rs1ls904907ejb.4.gmail; Thu, 02 Sep 2021 02:58:43 -0700 (PDT) X-Google-Smtp-Source: ABdhPJyRhjrCUdA2Mb/MgQlhF3jE+tkV22+f2cf9zolnFZHDCBFsOyk4nYR91sE9EGAYwCgGCi3u X-Received: by 2002:a17:906:7217:: with SMTP id m23mr2909538ejk.466.1630576723106; Thu, 02 Sep 2021 02:58:43 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1630576723; cv=none; d=google.com; s=arc-20160816; b=TjNPt5JLTmVgsXMhVP70IJb924rhHd95moTJX6IJ8OA410pyqfV5DKZwh+tsNCf5au wIhZUve006upXlNZrnJTV3kZL66TgM0sAjhHgMRJ2Rr9YQV79JonZwkChotfkp9MqDgz SgdlcBkBTcg+As0807k9ndxmN+YnizUfXnWvliGD89FMg7wRTkqgvFtC/2+3AMnGjoJx nBF1d/dgZRCgvjOaXvrIFN0HYU3W/CQFTIhXlNyLuOUP8B4z/buzHIVZtFIalKyLSRKi XP76ugh0HnqgPIzdCQJmBBc5xsB1IdR75s/s/HEsKzfwJwqihpzMQLinR2WTNHkYcKFe wA9A== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:to:from; bh=rKmEYa3d49b9mi8+QRyjUN7XTd1e5aL5zjg2313XhBw=; b=Az7P5kKYujC1ZX8mX8c21O6IEdhAWL07fYwDC5MFjKkicUgS8GL6h8GA4Qk/aeoVuS PClNJdYvjkaI9VzE8lbEuHELGqu3pOQextVyBbqdVl+qoN0/5WeB7Zg1Hja1eGszHMOP jgaZVuBelhHag6pTBMzdL6OURV7J3k+zBVHNdrDZfT/xozWrRUXO+L1oXBYUgpuiEYFw Z9yve+Z/t/0CLBppOuN6aNgiLaR5J0q3ifXwvCtcjjMVUsMEt+PavNWKnls4+kJREZlA 4ot4q2/GFt/bEwm1B8YPpFOsVmbs3LE1ucTt7l3gkaoqG1ZjwizV3NbnUlDjxYTiK7AM 4rXA== ARC-Authentication-Results: i=1; gmr-mx.google.com; spf=pass (google.com: domain of ubely@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=ubely@ilbers.de Return-Path: Received: from shymkent.ilbers.de (shymkent.ilbers.de. [85.214.156.166]) by gmr-mx.google.com with ESMTPS id e20si45447eds.4.2021.09.02.02.58.43 for (version=TLS1_2 cipher=ECDHE-ECDSA-CHACHA20-POLY1305 bits=256/256); Thu, 02 Sep 2021 02:58:43 -0700 (PDT) Received-SPF: pass (google.com: domain of ubely@ilbers.de designates 85.214.156.166 as permitted sender) client-ip=85.214.156.166; Authentication-Results: gmr-mx.google.com; spf=pass (google.com: domain of ubely@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=ubely@ilbers.de Received: from baighyz.m.ilbers.de (host-80-81-17-52.static.customer.m-online.net [80.81.17.52]) (authenticated bits=0) by shymkent.ilbers.de (8.15.2/8.15.2/Debian-8) with ESMTPSA id 1829wIgr012267 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Thu, 2 Sep 2021 11:58:38 +0200 From: Uladzimir Bely To: isar-users@googlegroups.com Subject: [RFC 4/4] doc: Add section for isar-apt reuse functionality Date: Thu, 2 Sep 2021 11:58:17 +0200 Message-Id: <20210902095817.32165-5-ubely@ilbers.de> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20210902095817.32165-1-ubely@ilbers.de> References: <20210902095817.32165-1-ubely@ilbers.de> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Spam-Status: No, score=-1.0 required=5.0 tests=ALL_TRUSTED autolearn=unavailable autolearn_force=no version=3.4.2 X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on shymkent.ilbers.de X-TUID: p/vk92SUmE03 Signed-off-by: Uladzimir Bely --- doc/user_manual.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/doc/user_manual.md b/doc/user_manual.md index 1da0e9d..94af2ea 100644 --- a/doc/user_manual.md +++ b/doc/user_manual.md @@ -21,6 +21,7 @@ Copyright (C) 2016-2019, ilbers GmbH - [Create an ISAR SDK root filesystem](#create-an-isar-sdk-root-filesystem) - [Create a containerized Isar SDK root filesystem](#create-a-containerized-isar-sdk-root-filesystem) - [Creation of local apt repo caching upstream Debian packages](#creation-of-local-apt-repo-caching-upstream-debian-packages) + - [Reusing isar-apt repository](#reusing-isar-apt-repository) ## Introduction @@ -1134,6 +1135,28 @@ sudo rm -rf tmp bitbake mc:qemuarm-buster:isar-image-base ``` +## Reusing isar-apt repository + +### Motivation + +Building custom recipes from sources may take a lot of time to download the sources and build the package. Also, reusing isar-apt makes it possible to work offline. + +### Solution + +After a custom package is built, it's placed into isar-apt repository. It's possible to reuse this repository for further builds. The behavior is controlled by `ISAR_APT_ALWAYS_REBUILD_ON_CHANGE` variable in `conf/local.conf`: + +- `ISAR_APT_ALWAYS_REBUILD_ON_CHANGE = "1"` - force rebuilding custom packages from sources +- `ISAR_APT_ALWAYS_REBUILD_ON_CHANGE = "0"` - reuse previously built binary if it exists in repository. + +If `ISAR_APT_ALWAYS_REBUILD_ON_CHANGE` is not set it behaves like it was set to `"0"` + +It also may be useful to move `isar-apt` directory out from `tmp/deploy` so that it could be easily shared between builds. To do that, modify `conf/local.conf` by adding lines similar to the following ones: + +``` +REPO_ISAR_DIR = "/path/to/isar-apt/${DISTRO}-${DISTRO_ARCH}/apt" +REPO_ISAR_DB_DIR = "/path/to/isar-apt/${DISTRO}-${DISTRO_ARCH}/db" +``` + ## Add foreign packages from other repositories to the generated image ### Motivation -- 2.20.1