From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from firstgate.proxmox.com (firstgate.proxmox.com [212.224.123.68]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits)) (No client certificate requested) by lists.proxmox.com (Postfix) with ESMTPS id 6B03A8AB3F for ; Fri, 21 Oct 2022 11:13:27 +0200 (CEST) Received: from firstgate.proxmox.com (localhost [127.0.0.1]) by firstgate.proxmox.com (Proxmox) with ESMTP id 4A46A1FA47 for ; Fri, 21 Oct 2022 11:12:57 +0200 (CEST) Received: from proxmox-new.maurer-it.com (proxmox-new.maurer-it.com [94.136.29.106]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits)) (No client certificate requested) by firstgate.proxmox.com (Proxmox) with ESMTPS for ; Fri, 21 Oct 2022 11:12:56 +0200 (CEST) Received: from proxmox-new.maurer-it.com (localhost.localdomain [127.0.0.1]) by proxmox-new.maurer-it.com (Proxmox) with ESMTP id 3E9F744AFC for ; Fri, 21 Oct 2022 11:12:56 +0200 (CEST) From: =?UTF-8?q?Fabian=20Gr=C3=BCnbichler?= To: pve-devel@lists.proxmox.com Date: Fri, 21 Oct 2022 11:12:44 +0200 Message-Id: <20221021091244.3846051-3-f.gruenbichler@proxmox.com> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20221021091244.3846051-1-f.gruenbichler@proxmox.com> References: <20221021091244.3846051-1-f.gruenbichler@proxmox.com> MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-SPAM-LEVEL: Spam detection results: 0 AWL 0.141 Adjusted score from AWL reputation of From: address BAYES_00 -1.9 Bayes spam probability is 0 to 1% KAM_DMARC_STATUS 0.01 Test Rule for DKIM or SPF Failure with Strict Alignment SPF_HELO_NONE 0.001 SPF: HELO does not publish an SPF Record SPF_PASS -0.001 SPF: sender matches SPF record Subject: [pve-devel] [PATCH proxmox-offline-mirror 3/3] docs: add section/package filters X-BeenThere: pve-devel@lists.proxmox.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Proxmox VE development discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 21 Oct 2022 09:13:27 -0000 Signed-off-by: Fabian Grünbichler --- docs/offline-mirror.rst | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/docs/offline-mirror.rst b/docs/offline-mirror.rst index ac78e9a..fde27ed 100644 --- a/docs/offline-mirror.rst +++ b/docs/offline-mirror.rst @@ -52,6 +52,34 @@ To create the first (and subsequent) snapshots, the following command can be use snapshot can take both time and require significant disk space. This is especially true for the initial snapshot, as subsequent ones will re-use unchanged package files and indices. +Reducing Mirror Scope +--------------------- + +There are different mechanisms for reducing a mirror's scope (and correspondingly, the amount of +traffic and disk space required to keep it synced): + +- architecture filters +- components (as part of the `repository` specification) +- package name and section filters + +By default, only packages for the architectures `all` (see note above) and `amd64` are mirrored. + +Optionally, it's possible to setup filters for downloaded binary or source packages via the +`--skip-packages` and `--skip-sections` options. The package filters support globbing, for example +`linux-image-*` will skip all packages with a name starting with `linux-image-`. The section +filters match the full value, or the value prefixed with the package's component (for example, +`games` will match both the section `games`, as well as `non-free/games` in a packages index of the +`non-free` component). + +Some examples for packages and section filters: + +- `--skip-packages 'linux-image-*'` - filter Debian linux kernel image packages +- `--skip-sections 'games'` - filter sections containing game packages +- `--skip-sections 'debug'` - filter sections containing debug information + +Please refer to https://packages.debian.org/bullseye/ for a list of Debian archive sections and +their contents. + Space Management ---------------- -- 2.30.2