[PATCH 0/3] Added support for apt caching

[PATCH 0/3] Added support for apt caching

[alexander.heinisch via isar-users]

From: Alexander Heinisch <alexander.heinisch@siemens.com>

Added DISTRO_APT_SNAPSHOT_PREMIRROR_BASE to specify the base-url of the mirror used.
    
This enables the use of local caches like apt-cache-ng when using
isar's snapshot facility. We also added Kconfig support for such
and a small (non-exhaustive) documentation how to use it in `doc/apt-cache.md`.


Alexander Heinisch (3):
  Added DISTRO_APT_SNAPSHOT_PREMIRROR_BASE to specify the base-url of
    the mirror used.
  Added Kconfig for cached snapshot mirror
  Added doc to setup apt cache.

 doc/apt-cache.md                        | 55 +++++++++++++++++++++++++
 kas/opt/Kconfig                         | 25 ++++++++++-
 kas/opt/mirror-snapshot.yaml            |  3 ++
 meta-isar/conf/distro/ubuntu-common.inc |  3 +-
 meta/conf/distro/debian-common.conf     |  3 +-
 5 files changed, 86 insertions(+), 3 deletions(-)
 create mode 100644 doc/apt-cache.md

-- 
2.43.0

-- 
You received this message because you are subscribed to the Google Groups "isar-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to isar-users+unsubscribe@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/isar-users/20240927190650.128263-1-alexander.heinisch%40siemens.com.

[PATCH 1/3] Added DISTRO_APT_SNAPSHOT_PREMIRROR_BASE to specify the base-url of the mirror used.

[alexander.heinisch via isar-users]

From: Alexander Heinisch <alexander.heinisch@siemens.com>

This enables the use of local caches like apt-cache-ng when using
isar's snapshot facility.
e.g. DISTRO_APT_SNAPSHOT_PREMIRROR_BASE=localhost:3142/snapshot.debian.org

Note: When setting the variable from the environment make sure you add it
to the kas file as follows. Make sure the default is null.
```
env:
  DISTRO_APT_SNAPSHOT_PREMIRROR_BASE: null
```

Signed-off-by: Alexander Heinisch <alexander.heinisch@siemens.com>
---
 meta-isar/conf/distro/ubuntu-common.inc | 3 ++-
 meta/conf/distro/debian-common.conf     | 3 ++-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/meta-isar/conf/distro/ubuntu-common.inc b/meta-isar/conf/distro/ubuntu-common.inc
index 232bee35..2c2f02f8 100644
--- a/meta-isar/conf/distro/ubuntu-common.inc
+++ b/meta-isar/conf/distro/ubuntu-common.inc
@@ -37,4 +37,5 @@ SYSTEMD_BOOTLOADER_INSTALL:focal = "systemd:${DISTRO_ARCH}"
 SYSTEMD_BOOTLOADER_INSTALL:jammy = "systemd:${DISTRO_ARCH}"
 
 # snapshot mirror for reproducible builds
-DISTRO_APT_SNAPSHOT_PREMIRROR ??= "(http|https)://archive.ubuntu.com/(.*) https://snapshot.ubuntu.com/\2/${APT_SNAPSHOT_DATE}/\n"
+DISTRO_APT_SNAPSHOT_PREMIRROR_BASE ??= "snapshot.ubuntu.com"
+DISTRO_APT_SNAPSHOT_PREMIRROR ??= "(http|https)://archive.ubuntu.com/(.*) https://${DISTRO_APT_SNAPSHOT_PREMIRROR_BASE}/\2/${APT_SNAPSHOT_DATE}/\n"
diff --git a/meta/conf/distro/debian-common.conf b/meta/conf/distro/debian-common.conf
index 8c6a3f63..de9e6933 100644
--- a/meta/conf/distro/debian-common.conf
+++ b/meta/conf/distro/debian-common.conf
@@ -40,4 +40,5 @@ COMPAT_DISTRO_ARCH:amd64 = "i386"
 COMPAT_DISTRO_ARCH:arm64 = "armhf"
 
 # snapshot mirror for reproducible builds
-DISTRO_APT_SNAPSHOT_PREMIRROR ??= "deb.debian.org/(.*) snapshot.debian.org/archive/\1/${APT_SNAPSHOT_DATE}/\n"
+DISTRO_APT_SNAPSHOT_PREMIRROR_BASE ??= "snapshot.debian.org"
+DISTRO_APT_SNAPSHOT_PREMIRROR ??= "deb.debian.org/(.*) ${DISTRO_APT_SNAPSHOT_PREMIRROR_BASE}/archive/\1/${APT_SNAPSHOT_DATE}/\n"
-- 
2.43.0

-- 
You received this message because you are subscribed to the Google Groups "isar-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to isar-users+unsubscribe@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/isar-users/20240927190650.128263-2-alexander.heinisch%40siemens.com.

Re: [PATCH 1/3] Added DISTRO_APT_SNAPSHOT_PREMIRROR_BASE to specify the base-url of the mirror used.

['Jan Kiszka' via isar-users]

On 27.09.24 21:06, alexander.heinisch via isar-users wrote:
> From: Alexander Heinisch <alexander.heinisch@siemens.com>
> 
> This enables the use of local caches like apt-cache-ng when using
> isar's snapshot facility.
> e.g. DISTRO_APT_SNAPSHOT_PREMIRROR_BASE=localhost:3142/snapshot.debian.org

Why "BASE"? Also with regular PREMIRROR, you do not need to rewrite the
whole URL, thus this is also with some "BASE" semantic. Just trying to
make the name shorter.

Jan

> 
> Note: When setting the variable from the environment make sure you add it
> to the kas file as follows. Make sure the default is null.
> ```
> env:
>   DISTRO_APT_SNAPSHOT_PREMIRROR_BASE: null
> ```
> 
> Signed-off-by: Alexander Heinisch <alexander.heinisch@siemens.com>
> ---
>  meta-isar/conf/distro/ubuntu-common.inc | 3 ++-
>  meta/conf/distro/debian-common.conf     | 3 ++-
>  2 files changed, 4 insertions(+), 2 deletions(-)
> 
> diff --git a/meta-isar/conf/distro/ubuntu-common.inc b/meta-isar/conf/distro/ubuntu-common.inc
> index 232bee35..2c2f02f8 100644
> --- a/meta-isar/conf/distro/ubuntu-common.inc
> +++ b/meta-isar/conf/distro/ubuntu-common.inc
> @@ -37,4 +37,5 @@ SYSTEMD_BOOTLOADER_INSTALL:focal = "systemd:${DISTRO_ARCH}"
>  SYSTEMD_BOOTLOADER_INSTALL:jammy = "systemd:${DISTRO_ARCH}"
>  
>  # snapshot mirror for reproducible builds
> -DISTRO_APT_SNAPSHOT_PREMIRROR ??= "(http|https)://archive.ubuntu.com/(.*) https://snapshot.ubuntu.com/\2/${APT_SNAPSHOT_DATE}/\n"
> +DISTRO_APT_SNAPSHOT_PREMIRROR_BASE ??= "snapshot.ubuntu.com"
> +DISTRO_APT_SNAPSHOT_PREMIRROR ??= "(http|https)://archive.ubuntu.com/(.*) https://${DISTRO_APT_SNAPSHOT_PREMIRROR_BASE}/\2/${APT_SNAPSHOT_DATE}/\n"
> diff --git a/meta/conf/distro/debian-common.conf b/meta/conf/distro/debian-common.conf
> index 8c6a3f63..de9e6933 100644
> --- a/meta/conf/distro/debian-common.conf
> +++ b/meta/conf/distro/debian-common.conf
> @@ -40,4 +40,5 @@ COMPAT_DISTRO_ARCH:amd64 = "i386"
>  COMPAT_DISTRO_ARCH:arm64 = "armhf"
>  
>  # snapshot mirror for reproducible builds
> -DISTRO_APT_SNAPSHOT_PREMIRROR ??= "deb.debian.org/(.*) snapshot.debian.org/archive/\1/${APT_SNAPSHOT_DATE}/\n"
> +DISTRO_APT_SNAPSHOT_PREMIRROR_BASE ??= "snapshot.debian.org"
> +DISTRO_APT_SNAPSHOT_PREMIRROR ??= "deb.debian.org/(.*) ${DISTRO_APT_SNAPSHOT_PREMIRROR_BASE}/archive/\1/${APT_SNAPSHOT_DATE}/\n"

-- 
Siemens AG, Technology
Linux Expert Center

-- 
You received this message because you are subscribed to the Google Groups "isar-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to isar-users+unsubscribe@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/isar-users/555ab11a-e6e8-4239-86d3-ec6831bbebe8%40siemens.com.

[PATCH 2/3] Added Kconfig for cached snapshot mirror

[alexander.heinisch via isar-users]

From: Alexander Heinisch <alexander.heinisch@siemens.com>

Signed-off-by: Alexander Heinisch <alexander.heinisch@siemens.com>
---
 kas/opt/Kconfig              | 25 ++++++++++++++++++++++++-
 kas/opt/mirror-snapshot.yaml |  3 +++
 2 files changed, 27 insertions(+), 1 deletion(-)

diff --git a/kas/opt/Kconfig b/kas/opt/Kconfig
index 65482e3a..ef08564c 100644
--- a/kas/opt/Kconfig
+++ b/kas/opt/Kconfig
@@ -7,6 +7,15 @@
 menu "Mirror selection"
 	depends on DEBIAN_BUSTER || DEBIAN_BULLSEYE || DEBIAN_BOOKWORM || DEBIAN_TRIXIE || DEBIAN_SID || UBUNTU_FOCAL || UBUNTU_JAMMY
 
+choice
+	prompt "Mirror type selection"
+	default MIRROR_NONE
+
+config MIRROR_NONE
+	bool "Don't use a mirror"
+	help
+	  Use apt urls as specified in apt.list
+
 config MIRROR_DEBIAN
 	bool "Use specific Debian mirror"
 	depends on DEBIAN_BUSTER || DEBIAN_BULLSEYE || DEBIAN_BOOKWORM || DEBIAN_TRIXIE || DEBIAN_SID
@@ -42,7 +51,6 @@ config KAS_INCLUDE_MIRROR_UBUNTU
 
 config USE_APT_SNAPSHOT
 	bool "Use the distros snapshot mirror"
-	depends on !MIRROR_DEBIAN && (DEBIAN_BUSTER || DEBIAN_BULLSEYE || DEBIAN_BOOKWORM || DEBIAN_TRIXIE || DEBIAN_SID || UBUNTU_FOCAL || UBUNTU_JAMMY)
 	help
 		Use a snapshot mirror for the selected distribution. The date is defined by ISAR_APT_SNAPSHOT_TIMESTAMP.
 
@@ -51,6 +59,21 @@ config KAS_INCLUDE_APT_SNAPSHOT
 	default "kas/opt/mirror-snapshot.yaml"
 	depends on USE_APT_SNAPSHOT
 
+config USE_APT_SNAPSHOT_CACHED
+	bool "Use a cache for snapshot mirror"
+	depends on USE_APT_SNAPSHOT
+
+config DISTRO_APT_SNAPSHOT_PREMIRROR_BASE
+	string "Base URL of the snapshot mirror"
+	default "localhost:3142/snapshot.debian.org"
+	depends on USE_APT_SNAPSHOT_CACHED
+	help
+	  Set the premirror base url used for snapshots.
+	  This can either be a local cache (e.g.: localhost:3142/snapshot.debian.org) or
+	  any mirror like snapshot.debian.org used to retrieve snapshots from.
+
+endchoice
+
 endmenu
 
 
diff --git a/kas/opt/mirror-snapshot.yaml b/kas/opt/mirror-snapshot.yaml
index 59fae192..493e1552 100644
--- a/kas/opt/mirror-snapshot.yaml
+++ b/kas/opt/mirror-snapshot.yaml
@@ -7,3 +7,6 @@ header:
 local_conf_header:
   mirror-debian: |
     ISAR_USE_APT_SNAPSHOT = "1"
+
+env:
+  DISTRO_APT_SNAPSHOT_PREMIRROR_BASE: null
-- 
2.43.0

-- 
You received this message because you are subscribed to the Google Groups "isar-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to isar-users+unsubscribe@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/isar-users/20240927190650.128263-3-alexander.heinisch%40siemens.com.

[PATCH 3/3] Added doc to setup apt cache.

[alexander.heinisch via isar-users]

From: Alexander Heinisch <alexander.heinisch@siemens.com>

Signed-off-by: Alexander Heinisch <alexander.heinisch@siemens.com>
---
 doc/apt-cache.md | 55 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 55 insertions(+)
 create mode 100644 doc/apt-cache.md

diff --git a/doc/apt-cache.md b/doc/apt-cache.md
new file mode 100644
index 00000000..f03ea7ee
--- /dev/null
+++ b/doc/apt-cache.md
@@ -0,0 +1,55 @@
+# Using an APT Cache
+
+When working on the road limited download bandwitdth oftentimes is an issue, and increases the build times drastically.
+On the other hand large corporate networks could get rate limited by debian mirrors, as many peoply / pipelines / aso.
+fetch huge amounts of packets.
+
+An apt cache can mitigate these issues.
+
+## Setup
+
+1. Install apt cache
+
+```
+apt install apt-cache-ng
+```
+
+## Using the cache using premirrors
+
+1. Set `DISTRO_APT_PREMIRRORS` in your projects `bitbake` or `kas` config:
+
+```
+DISTRO_APT_PREMIRRORS="http://deb\.debian\.org http://localhost:3142/deb.debian.org"\n""
+```
+
+1. Invoke `kas menu` and select
+    1. `Mirror selection ->
+    1. Use specific (Debian | Ubuntu) mirror ->
+    1. URL of (Debian | Ubuntu) mirror (e.g. `http://localhost:3142/deb.debian.org`).
+
+
+## Using the cache when snapshot builds are configured
+
+When you chose to use isar's snapshot mechanism:
+```
+ISAR_USE_APT_SNAPSHOT = "1"
+```
+you can enable the cache, depending on your build environment, as follows:
+
+1. Set `DISTRO_APT_SNAPSHOT_PREMIRROR_BASE` in your projects `bitbake` or `kas` config:
+
+```
+DISTRO_APT_SNAPSHOT_PREMIRROR_BASE=localhost:3142/snapshot.debian.org
+```
+
+1. Set `DISTRO_APT_SNAPSHOT_PREMIRROR_BASE`  in your environment and include `kas/opt/mirror-snapshot.yaml` to your kas file or append it on kas cli invokation.
+
+1. Invoke `kas menu` and select
+    1. `Mirror selection ->
+    1. Use the distros snapshot mirror ->
+    1. Use a cache for snapshot mirror and specify the snapshot mirror you prefer (e.g. `localhost:3142/snapshot.debian.org`).
+
+
+> Note: When invoking the build in a containerized environment like `kas/kas-container menu`, you have to specify the ip address of the machine running `apt-cacher-ng`.
+
+> Note: To limit access to the `apt-cacher-ng`, a dummy network interface can help!
-- 
2.43.0

-- 
You received this message because you are subscribed to the Google Groups "isar-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to isar-users+unsubscribe@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/isar-users/20240927190650.128263-4-alexander.heinisch%40siemens.com.

Re: [PATCH 3/3] Added doc to setup apt cache.

['Niedermayr, BENEDIKT' via isar-users]

On Fri, 2024-09-27 at 21:06 +0200, alexander.heinisch via isar-users wrote:
> From: Alexander Heinisch <alexander.heinisch@siemens.com>
> 
> Signed-off-by: Alexander Heinisch <alexander.heinisch@siemens.com>
> ---
>  doc/apt-cache.md | 55 ++++++++++++++++++++++++++++++++++++++++++++++++
>  1 file changed, 55 insertions(+)
>  create mode 100644 doc/apt-cache.md
> 
> diff --git a/doc/apt-cache.md b/doc/apt-cache.md
> new file mode 100644
> index 00000000..f03ea7ee
> --- /dev/null
> +++ b/doc/apt-cache.md
> @@ -0,0 +1,55 @@
> +# Using an APT Cache
> +
> +When working on the road limited download bandwitdth oftentimes is an issue, and increases the
> build times drastically.
> +On the other hand large corporate networks could get rate limited by debian mirrors, as many
> peoply / pipelines / aso.
Just a small typo here. You mean "people", don't you?

> +fetch huge amounts of packets.
> +
> +An apt cache can mitigate these issues.
> +
> +## Setup
> +
> +1. Install apt cache
> +
> +```
> +apt install apt-cache-ng
> +```
> +
> +## Using the cache using premirrors
> +
> +1. Set `DISTRO_APT_PREMIRRORS` in your projects `bitbake` or `kas` config:
> +
> +```
> +DISTRO_APT_PREMIRRORS="http://deb\.debian\.org http://localhost:3142/deb.debian.org"\n""
> +```
> +
> +1. Invoke `kas menu` and select
> +    1. `Mirror selection ->
> +    1. Use specific (Debian | Ubuntu) mirror ->
> +    1. URL of (Debian | Ubuntu) mirror (e.g. `http://localhost:3142/deb.debian.org`).
> +
> +
> +## Using the cache when snapshot builds are configured
> +
> +When you chose to use isar's snapshot mechanism:
> +```
> +ISAR_USE_APT_SNAPSHOT = "1"
> +```
> +you can enable the cache, depending on your build environment, as follows:
> +
> +1. Set `DISTRO_APT_SNAPSHOT_PREMIRROR_BASE` in your projects `bitbake` or `kas` config:
> +
> +```
> +DISTRO_APT_SNAPSHOT_PREMIRROR_BASE=localhost:3142/snapshot.debian.org
> +```
> +
> +1. Set `DISTRO_APT_SNAPSHOT_PREMIRROR_BASE`  in your environment and include `kas/opt/mirror-
> snapshot.yaml` to your kas file or append it on kas cli invokation.
Same here: "invocation"

Regards,
Benedikt
> +
> +1. Invoke `kas menu` and select
> +    1. `Mirror selection ->
> +    1. Use the distros snapshot mirror ->
> +    1. Use a cache for snapshot mirror and specify the snapshot mirror you prefer (e.g.
> `localhost:3142/snapshot.debian.org`).
> +
> +
> +> Note: When invoking the build in a containerized environment like `kas/kas-container menu`, you
> have to specify the ip address of the machine running `apt-cacher-ng`.
> +
> +> Note: To limit access to the `apt-cacher-ng`, a dummy network interface can help!
> -- 
> 2.43.0
> 

-- 
You received this message because you are subscribed to the Google Groups "isar-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to isar-users+unsubscribe@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/isar-users/454c7012c29fb20a0269251c664568a691c30e89.camel%40siemens.com.

Re: [PATCH 0/3] Added support for apt caching

['MOESSBAUER, Felix' via isar-users]

On Fri, 2024-09-27 at 21:06 +0200, alexander.heinisch@siemens.com
wrote:
> From: Alexander Heinisch <alexander.heinisch@siemens.com>
> 
> Added DISTRO_APT_SNAPSHOT_PREMIRROR_BASE to specify the base-url of
> the mirror used.
>     
> This enables the use of local caches like apt-cache-ng when using
> isar's snapshot facility. We also added Kconfig support for such
> and a small (non-exhaustive) documentation how to use it in `doc/apt-
> cache.md`.

Hi,

Acked-by: Felix Moessbauer <felix.moessbauer@siemens.com>

Felix

> 
> 
> Alexander Heinisch (3):
>   Added DISTRO_APT_SNAPSHOT_PREMIRROR_BASE to specify the base-url of
>     the mirror used.
>   Added Kconfig for cached snapshot mirror
>   Added doc to setup apt cache.
> 
>  doc/apt-cache.md                        | 55
> +++++++++++++++++++++++++
>  kas/opt/Kconfig                         | 25 ++++++++++-
>  kas/opt/mirror-snapshot.yaml            |  3 ++
>  meta-isar/conf/distro/ubuntu-common.inc |  3 +-
>  meta/conf/distro/debian-common.conf     |  3 +-
>  5 files changed, 86 insertions(+), 3 deletions(-)
>  create mode 100644 doc/apt-cache.md
> 

-- 
Siemens AG, Technology
Linux Expert Center


-- 
You received this message because you are subscribed to the Google Groups "isar-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to isar-users+unsubscribe@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/isar-users/5461061ab5739d3ab2385e39d9efb96cabdea53f.camel%40siemens.com.

Re: [PATCH 0/3] Added support for apt caching

[Uladzimir Bely]

On Fri, 2024-09-27 at 21:06 +0200, alexander.heinisch via isar-users
wrote:
> From: Alexander Heinisch <alexander.heinisch@siemens.com>
> 
> Added DISTRO_APT_SNAPSHOT_PREMIRROR_BASE to specify the base-url of
> the mirror used.
>     
> This enables the use of local caches like apt-cache-ng when using
> isar's snapshot facility. We also added Kconfig support for such
> and a small (non-exhaustive) documentation how to use it in `doc/apt-
> cache.md`.
> 
> 
> Alexander Heinisch (3):
>   Added DISTRO_APT_SNAPSHOT_PREMIRROR_BASE to specify the base-url of
>     the mirror used.
>   Added Kconfig for cached snapshot mirror
>   Added doc to setup apt cache.
> 
>  doc/apt-cache.md                        | 55
> +++++++++++++++++++++++++
>  kas/opt/Kconfig                         | 25 ++++++++++-
>  kas/opt/mirror-snapshot.yaml            |  3 ++
>  meta-isar/conf/distro/ubuntu-common.inc |  3 +-
>  meta/conf/distro/debian-common.conf     |  3 +-
>  5 files changed, 86 insertions(+), 3 deletions(-)
>  create mode 100644 doc/apt-cache.md
> 
> -- 
> 2.43.0
> 

Hello all.

The series has passed CI multiple times and is ready to be merged, but
p1 is not still addressed. Is v2 expected?

-- 
Best regards,
Uladzimir.



-- 
You received this message because you are subscribed to the Google Groups "isar-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to isar-users+unsubscribe@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/isar-users/9093339262ec7d1866abbc8345dcf9fc498e341e.camel%40ilbers.de.

RE: [PATCH 0/3] Added support for apt caching

['Heinisch, Alexander' via isar-users]

> Hello all.
> 
> The series has passed CI multiple times and is ready to be merged, but
> p1 is not still addressed. Is v2 expected?

Repost for new readers:

> > This enables the use of local caches like apt-cache-ng when using
> > isar's snapshot facility.
> > e.g. DISTRO_APT_SNAPSHOT_PREMIRROR_BASE=localhost:3142/snapshot.debian.org
> 
> Why "BASE"? Also with regular PREMIRROR, you do not need to rewrite the
> whole URL, thus this is also with some "BASE" semantic. Just trying to
> make the name shorter.

I was struggeling with the naming, too, and still am finding a better one!
What about `ISAR_APT_SNAPSHOT_MIRROR`?

Any suggestions for naming welcome :-)

BR Alexander

-- 
You received this message because you are subscribed to the Google Groups "isar-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to isar-users+unsubscribe@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/isar-users/AM7PR10MB332098D68FAD5101B96B5C30867E2%40AM7PR10MB3320.EURPRD10.PROD.OUTLOOK.COM.

Re: [PATCH 0/3] Added support for apt caching

['Jan Kiszka' via isar-users]

On 08.10.24 08:43, Heinisch, Alexander (FT RPD CED SES-AT) wrote:
>> Hello all.
>>
>> The series has passed CI multiple times and is ready to be merged, but
>> p1 is not still addressed. Is v2 expected?
> 
> Repost for new readers:
> 
>>> This enables the use of local caches like apt-cache-ng when using
>>> isar's snapshot facility.
>>> e.g. DISTRO_APT_SNAPSHOT_PREMIRROR_BASE=localhost:3142/snapshot.debian.org
>>
>> Why "BASE"? Also with regular PREMIRROR, you do not need to rewrite the
>> whole URL, thus this is also with some "BASE" semantic. Just trying to
>> make the name shorter.
> 
> I was struggeling with the naming, too, and still am finding a better one!
> What about `ISAR_APT_SNAPSHOT_MIRROR`?
> 
> Any suggestions for naming welcome :-)
> 

MIRROR = used as fallback if official URL does not work
PREMIRROR = tried before official URL, falling back to that one on failure

Jan

-- 
Siemens AG, Technology
Linux Expert Center

-- 
You received this message because you are subscribed to the Google Groups "isar-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to isar-users+unsubscribe@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/isar-users/d40a6d85-0158-4470-a8a6-8ef5e65d8e4f%40siemens.com.

Re: [PATCH 0/3] Added support for apt caching

['MOESSBAUER, Felix' via isar-users]

On Tue, 2024-10-08 at 14:38 +0200, 'Jan Kiszka' via isar-users wrote:
> On 08.10.24 08:43, Heinisch, Alexander (FT RPD CED SES-AT) wrote:
> > > Hello all.
> > > 
> > > The series has passed CI multiple times and is ready to be
> > > merged, but
> > > p1 is not still addressed. Is v2 expected?
> > 
> > Repost for new readers:
> > 
> > > > This enables the use of local caches like apt-cache-ng when
> > > > using
> > > > isar's snapshot facility.
> > > > e.g.
> > > > DISTRO_APT_SNAPSHOT_PREMIRROR_BASE=localhost:3142/snapshot.debi
> > > > an.org
> > > 
> > > Why "BASE"? Also with regular PREMIRROR, you do not need to
> > > rewrite the
> > > whole URL, thus this is also with some "BASE" semantic. Just
> > > trying to
> > > make the name shorter.
> > 
> > I was struggeling with the naming, too, and still am finding a
> > better one!
> > What about `ISAR_APT_SNAPSHOT_MIRROR`?
> > 
> > Any suggestions for naming welcome :-)
> > 
> 
> MIRROR = used as fallback if official URL does not work
> PREMIRROR = tried before official URL, falling back to that one on
> failure

Hi, this series is much needed to work with the still unreliable
snapshot mirrors.

@Alexander: Do you plan to send a v2?

At the same time I'm working on adding internal apt-cacher-ng support
to kas to let the build pass the initial bootstrapping.

Best regards,
Felix

> 
> Jan
> 
> -- 
> Siemens AG, Technology
> Linux Expert Center
> 

-- 
Siemens AG, Technology
Linux Expert Center


-- 
You received this message because you are subscribed to the Google Groups "isar-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to isar-users+unsubscribe@googlegroups.com.
To view this discussion visit https://groups.google.com/d/msgid/isar-users/8604a9552135790de2df1a7fc05c31bc07075259.camel%40siemens.com.

RE: [PATCH 0/3] Added support for apt caching

['Heinisch, Alexander' via isar-users]

> Hi, this series is much needed to work with the still unreliable snapshot mirrors.
> 
> @Alexander: Do you plan to send a v2?
> 
> At the same time I'm working on adding internal apt-cacher-ng support to kas to let the build pass the initial bootstrapping.
> 
> Best regards,
> Felix

Hi Felix

Thank you for coming back.

Even when using apt-cacher-ng index files oftentimes got updated from
snapshot.debian.org which caused problems when our company was on a
blacklist for some time again.

Unfortunately, I didn't find the time to analyze why that was the case.
I did a tcpdump during one of our builds, but didn't analyze it for 2 weeks or so :-(

But I suspect either apt client sends a reload request or the expiry date 
returned from upstream is to limited.
While this could be relevant when fetching packages from "main" mirrors, 
it should not have much impact on snapshot mirrors.

To mitigate that issue, since then we switched to squid as a proxy for snapshot.debian.org
Squid has an offline mode, which says, no matter what happens, cach entries once
seen are never updated upstream. As stated above, while this could have drastic
impacts when using main mirrors, it shouldn't cause issues on snapshots, by definition.

Thus, I dropped apt-cacher-ng in our project in favour of squid.
I also prepared documentation for such, but during preparing the patch, I 
was not sure if that is worth a separate doc/ file or if we should merge that with
doc/offline.md. I was struggling with that decision since it does not really 
solve an offline case, as it only caches packages already seen once, and further, 
only solves the offline case for apt and not for other sources like git, ...

What is your opinion?

BR Alexander

PS: Appended the patch, I was referring to:

From cf64db474c2f2477633bfe3fd111156d2ac7495a Mon Sep 17 00:00:00 2001
From: Alexander Heinisch <alexander.heinisch@siemens.com>
Date: Thu, 24 Oct 2024 20:06:23 +0200
Subject: [PATCH] doc: Added setup guide for squid as an caching proxy for apt
 (snapshot) mirrors.

Signed-off-by: Alexander Heinisch <alexander.heinisch@siemens.com>
---
 doc/apt-caching-proxy.md | 142 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 142 insertions(+)
 create mode 100644 doc/apt-caching-proxy.md

diff --git a/doc/apt-caching-proxy.md b/doc/apt-caching-proxy.md
new file mode 100644
index 00000000..2a23a313
--- /dev/null
+++ b/doc/apt-caching-proxy.md
@@ -0,0 +1,142 @@
+# Setup Squid as APT Caching Proxy
+
+Limited download bandwitdth oftentimes is an issue, and increases the build times drastically. Further, large corporate networks could get rate limited by debian mirrors, as many people / pipelines / aso. fetch huge amounts of packets from there.
+
+In such cases a proxy caching the packages is quite useful as it reduces download times and reduces pressure on debian mirrors.
+
+## Install Squid Proxy
+```
+apt install squid
+```
+
+## Configure Proxy for Caching (with APT in mind)
+
+1. /etc/squid/squid.conf
+This file contains the main configuration for `squid`.
+We configure it to listen to port `4242` and cache all requests from sites listed in `/etc/squid/mirror-dstdomain.acl`. Further, to enable, offline usecases (or usecases where your ip got temporarily blacklisted by `snapshot.debian.org` or similar) we set `offline_mode on`
+to not fetch already cached packages from upstream.
+
+> Note: While `offline_mode on` is totally fine for `snapshot.debian.org` when using a timestamp to fix your package archive version, this could cause unintended behaviour (most probably outdated packages) when used against a non archive mirror.
+
+> Hint: If you are planning to work against non archive mirrors, and you are not sure, it's recommended to set `offline_mode off` and probably tweak cache behaviour with a `refresh_pattern`.
+
+### /etc/squid/squid.conf:
+```
+# File: /etc/squid/squid.conf
+
+# default to a different port than stock squid
+http_port 4242
+
+# user visible name
+visible_hostname squid-apt-caching-proxy
+
+# do not fetch already cached packages from upstream
+offline_mode on
+
+# we need a big cache, some debs are huge
+maximum_object_size 512 MB
+
+# increase available disk space for cache dir to 40G
+cache_dir aufs /var/cache/squid 40000 16 256
+
+# logs
+access_log /var/log/squid/access.log
+cache_log /var/log/squid/cache.log
+cache_store_log /var/log/squid/store.log
+
+# tweaks to speed things up
+cache_mem 256 MB
+maximum_object_size_in_memory 10240 KB
+
+# only allow ports we trust
+acl Safe_ports port 80
+acl Safe_ports port 443
+
+http_access deny !Safe_ports
+
+# Deny access to blacklisted sites
+acl blockedpkgs urlpath_regex "/etc/squid/pkg-blacklist-regexp.acl"
+http_access deny blockedpkgs
+
+# List of domains to cache
+acl to_archive_mirrors dstdomain "/etc/squid/mirror-dstdomain.acl"
+# don't cache domains not listed in the mirrors file
+cache deny !to_archive_mirrors
+
+# Allow access to the proxy only from networks listed in allowed-networks-src.acl
+acl allowed_networks src "/etc/squid/allowed-networks-src.acl"
+http_access allow allowed_networks
+
+# And finally deny all other access to this proxy
+http_access deny all
+```
+
+### /etc/squid/mirror-dstdomain.acl:
+```
+# File: /etc/squid/mirror-dstdomain.acl
+
+snapshot.debian.org
+```
+
+### /etc/squid/pkg-blacklist-regexp.acl:
+```
+# File: /etc/squid/pkg-blacklist-regexp.acl
+# Empty for now
+```
+
+### /etc/squid/allowed-networks-src.acl:
+```
+# File: /etc/squid/allowed-networks-src.acl
+
+# network sources that you want to allow access to the cache
+
+# private networks
+10.0.0.0/8
+172.16.0.0/12
+192.168.0.0/16
+127.0.0.1
+
+# IPv6 private addresses
+fe80::/64
+::1/128
+
+# IPv6 mesh local
+fd00::/8
+```
+
+Restart `systemctl restart squid`
+
+## Use the Proxy in ISAR Build System
+
+To forward the proxy settings to apt inside the ISAR build system just export `http_proxy`
+as follows:
+
+```
+export http_proxy=http://<proxy-server-ip>:4242
+```
+
+> Hint: Consider also setting `https_proxy`.
+
+### Validation
+
+The first time you build your image the cache will fetch all packages from upstream.
+During that phase you will see log entries, like
+
+```
+... TCP_MISS/200 1574478 GET http://snapshot.debian.org/file/7cfaf...
+```
+in `/var/log/squid/access.log`.
+
+From that time on for existing packages only
+
+```
+... TCP_OFFLINE_HIT/200 1574480 GET http://snapshot.debian.org/file/7cfaf...
+... TCP_MEM_HIT/200 1574480 GET http://snapshot.debian.org/file/7cfaf...
+```
+
+> Note: When you add new packages to your image, these have to be fetched first, so you will encounter `TCP_MISS`es whenever you add packages you didn't fetched before. Same holds true when upgrading the snapshot timestamp (`ISAR_APT_SNAPSHOT_TIMESTAMP` or `ISAR_APT_SNAPSHOT_DATE`).
+
+> Hint: You can observe your cache misses using:
+> ```
+> tail -f /var/log/squid/access.log | grep -e TCP_MEM_HIT -e TCP_OFFLINE_HIT -v
+> ```
-- 
2.43.0

-- 
You received this message because you are subscribed to the Google Groups "isar-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to isar-users+unsubscribe@googlegroups.com.
To view this discussion visit https://groups.google.com/d/msgid/isar-users/AM7PR10MB33207841E236025B621B725486552%40AM7PR10MB3320.EURPRD10.PROD.OUTLOOK.COM.

Re: [PATCH 0/3] Added support for apt caching

['MOESSBAUER, Felix' via isar-users]

On Thu, 2024-10-31 at 15:40 +0000, Heinisch, Alexander (FT RPD CED SES-
AT) wrote:
> > Hi, this series is much needed to work with the still unreliable
> > snapshot mirrors.
> > 
> > @Alexander: Do you plan to send a v2?
> > 
> > At the same time I'm working on adding internal apt-cacher-ng
> > support to kas to let the build pass the initial bootstrapping.
> > 
> > Best regards,
> > Felix
> 
> Hi Felix
> 
> Thank you for coming back.
> 
> Even when using apt-cacher-ng index files oftentimes got updated from
> snapshot.debian.org which caused problems when our company was on a
> blacklist for some time again.

I know, but this is partially also due to bugs in the apt-cacher-ng
implementation. Today it completely broke after an upstream change on
snapshot.d.o requiring a backport of the fix in [1]. I just sent an
email to the snapshot ML requesting the backport.

[1] https://bugs-devel.debian.org/cgi-bin/bugreport.cgi?bug=1074404

> 
> Unfortunately, I didn't find the time to analyze why that was the
> case.
> I did a tcpdump during one of our builds, but didn't analyze it for 2
> weeks or so :-(
> 
> But I suspect either apt client sends a reload request or the expiry
> date 
> returned from upstream is to limited.

It could also simply due to incorrect parsing of the expiry dates in
apt-cacher-ng. Recently there were a lot of fixes regarding time
parsing. Tricky to debug, though...

> While this could be relevant when fetching packages from "main"
> mirrors, 
> it should not have much impact on snapshot mirrors.
> 
> To mitigate that issue, since then we switched to squid as a proxy
> for snapshot.debian.org
> Squid has an offline mode, which says, no matter what happens, cach
> entries once
> seen are never updated upstream. As stated above, while this could
> have drastic
> impacts when using main mirrors, it shouldn't cause issues on
> snapshots, by definition.
> 
> Thus, I dropped apt-cacher-ng in our project in favour of squid.
> I also prepared documentation for such, but during preparing the
> patch, I 
> was not sure if that is worth a separate doc/ file or if we should
> merge that with
> doc/offline.md. I was struggling with that decision since it does not
> really 
> solve an offline case, as it only caches packages already seen once,
> and further, 
> only solves the offline case for apt and not for other sources like
> git, ...

Actually I'm more interested in having stable builds against
snapshot.d.o, not so much in 100% offline builds. The situation
upstream also got a bit better by rate-limiting on HTTP basis instead
of TCP basis, so clients (including apt-cacher-ng and squid) should be
able to correctly backoff. But I also did not check if the rate-
limiting is implemented correctly, so that the client knows when to
retry...

Anyways, we have a dilemma here: We need a stable baseline to build
against (both due to product requirements, as well as for the SState
cache). But currently it is REALLY hard to get this working in CI
builds.

> 
> What is your opinion?

Probably we need both, until it is not clear which solution is long-
term stable.

Felix

> 
> BR Alexander
> 
> PS: Appended the patch, I was referring to:
> 
> From cf64db474c2f2477633bfe3fd111156d2ac7495a Mon Sep 17 00:00:00
> 2001
> From: Alexander Heinisch <alexander.heinisch@siemens.com>
> Date: Thu, 24 Oct 2024 20:06:23 +0200
> Subject: [PATCH] doc: Added setup guide for squid as an caching proxy
> for apt
>  (snapshot) mirrors.
> 
> Signed-off-by: Alexander Heinisch <alexander.heinisch@siemens.com>
> ---
>  doc/apt-caching-proxy.md | 142
> +++++++++++++++++++++++++++++++++++++++
>  1 file changed, 142 insertions(+)
>  create mode 100644 doc/apt-caching-proxy.md
> 
> diff --git a/doc/apt-caching-proxy.md b/doc/apt-caching-proxy.md
> new file mode 100644
> index 00000000..2a23a313
> --- /dev/null
> +++ b/doc/apt-caching-proxy.md
> @@ -0,0 +1,142 @@
> +# Setup Squid as APT Caching Proxy
> +
> +Limited download bandwitdth oftentimes is an issue, and increases
> the build times drastically. Further, large corporate networks could
> get rate limited by debian mirrors, as many people / pipelines / aso.
> fetch huge amounts of packets from there.
> +
> +In such cases a proxy caching the packages is quite useful as it
> reduces download times and reduces pressure on debian mirrors.
> +
> +## Install Squid Proxy
> +```
> +apt install squid
> +```
> +
> +## Configure Proxy for Caching (with APT in mind)
> +
> +1. /etc/squid/squid.conf
> +This file contains the main configuration for `squid`.
> +We configure it to listen to port `4242` and cache all requests from
> sites listed in `/etc/squid/mirror-dstdomain.acl`. Further, to
> enable, offline usecases (or usecases where your ip got temporarily
> blacklisted by `snapshot.debian.org` or similar) we set `offline_mode
> on`
> +to not fetch already cached packages from upstream.
> +
> +> Note: While `offline_mode on` is totally fine for
> `snapshot.debian.org` when using a timestamp to fix your package
> archive version, this could cause unintended behaviour (most probably
> outdated packages) when used against a non archive mirror.
> +
> +> Hint: If you are planning to work against non archive mirrors, and
> you are not sure, it's recommended to set `offline_mode off` and
> probably tweak cache behaviour with a `refresh_pattern`.
> +
> +### /etc/squid/squid.conf:
> +```
> +# File: /etc/squid/squid.conf
> +
> +# default to a different port than stock squid
> +http_port 4242
> +
> +# user visible name
> +visible_hostname squid-apt-caching-proxy
> +
> +# do not fetch already cached packages from upstream
> +offline_mode on
> +
> +# we need a big cache, some debs are huge
> +maximum_object_size 512 MB
> +
> +# increase available disk space for cache dir to 40G
> +cache_dir aufs /var/cache/squid 40000 16 256
> +
> +# logs
> +access_log /var/log/squid/access.log
> +cache_log /var/log/squid/cache.log
> +cache_store_log /var/log/squid/store.log
> +
> +# tweaks to speed things up
> +cache_mem 256 MB
> +maximum_object_size_in_memory 10240 KB
> +
> +# only allow ports we trust
> +acl Safe_ports port 80
> +acl Safe_ports port 443
> +
> +http_access deny !Safe_ports
> +
> +# Deny access to blacklisted sites
> +acl blockedpkgs urlpath_regex "/etc/squid/pkg-blacklist-regexp.acl"
> +http_access deny blockedpkgs
> +
> +# List of domains to cache
> +acl to_archive_mirrors dstdomain "/etc/squid/mirror-dstdomain.acl"
> +# don't cache domains not listed in the mirrors file
> +cache deny !to_archive_mirrors
> +
> +# Allow access to the proxy only from networks listed in allowed-
> networks-src.acl
> +acl allowed_networks src "/etc/squid/allowed-networks-src.acl"
> +http_access allow allowed_networks
> +
> +# And finally deny all other access to this proxy
> +http_access deny all
> +```
> +
> +### /etc/squid/mirror-dstdomain.acl:
> +```
> +# File: /etc/squid/mirror-dstdomain.acl
> +
> +snapshot.debian.org
> +```
> +
> +### /etc/squid/pkg-blacklist-regexp.acl:
> +```
> +# File: /etc/squid/pkg-blacklist-regexp.acl
> +# Empty for now
> +```
> +
> +### /etc/squid/allowed-networks-src.acl:
> +```
> +# File: /etc/squid/allowed-networks-src.acl
> +
> +# network sources that you want to allow access to the cache
> +
> +# private networks
> +10.0.0.0/8
> +172.16.0.0/12
> +192.168.0.0/16
> +127.0.0.1
> +
> +# IPv6 private addresses
> +fe80::/64
> +::1/128
> +
> +# IPv6 mesh local
> +fd00::/8
> +```
> +
> +Restart `systemctl restart squid`
> +
> +## Use the Proxy in ISAR Build System
> +
> +To forward the proxy settings to apt inside the ISAR build system
> just export `http_proxy`
> +as follows:
> +
> +```
> +export http_proxy=http://<proxy-server-ip>:4242
> +```
> +
> +> Hint: Consider also setting `https_proxy`.
> +
> +### Validation
> +
> +The first time you build your image the cache will fetch all
> packages from upstream.
> +During that phase you will see log entries, like
> +
> +```
> +... TCP_MISS/200 1574478 GET
> http://snapshot.debian.org/file/7cfaf...
> +```
> +in `/var/log/squid/access.log`.
> +
> +From that time on for existing packages only
> +
> +```
> +... TCP_OFFLINE_HIT/200 1574480 GET
> http://snapshot.debian.org/file/7cfaf...
> +... TCP_MEM_HIT/200 1574480 GET
> http://snapshot.debian.org/file/7cfaf...
> +```
> +
> +> Note: When you add new packages to your image, these have to be
> fetched first, so you will encounter `TCP_MISS`es whenever you add
> packages you didn't fetched before. Same holds true when upgrading
> the snapshot timestamp (`ISAR_APT_SNAPSHOT_TIMESTAMP` or
> `ISAR_APT_SNAPSHOT_DATE`).
> +
> +> Hint: You can observe your cache misses using:
> +> ```
> +> tail -f /var/log/squid/access.log | grep -e TCP_MEM_HIT -e
> TCP_OFFLINE_HIT -v
> +> ```
> -- 
> 2.43.0
> 

-- 
Siemens AG, Technology
Linux Expert Center


-- 
You received this message because you are subscribed to the Google Groups "isar-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to isar-users+unsubscribe@googlegroups.com.
To view this discussion visit https://groups.google.com/d/msgid/isar-users/37f9067a2c3372a3d8c7a1402b9739869677bec9.camel%40siemens.com.

RE: [PATCH 0/3] Added support for apt caching

['Heinisch, Alexander' via isar-users]

> On Thu, 2024-10-31 at 15:40 +0000, Heinisch, Alexander (FT RPD CED SES-
> AT) wrote:
> > > Hi, this series is much needed to work with the still unreliable
> > > snapshot mirrors.
> > >
> > > @Alexander: Do you plan to send a v2?
> > >
> > > At the same time I'm working on adding internal apt-cacher-ng
> > > support to kas to let the build pass the initial bootstrapping.
> > >
> > > Best regards,
> > > Felix
> >
> > Hi Felix
> >
> > Thank you for coming back.
> >
> > Even when using apt-cacher-ng index files oftentimes got updated from
> > snapshot.debian.org which caused problems when our company was on a
> > blacklist for some time again.
>
> I know, but this is partially also due to bugs in the apt-cacher-ng implementation. Today it completely broke after an upstream change on snapshot.d.o requiring a backport of the fix in [1]. I just sent an email to the snapshot ML requesting the backport.

Yes, apt-cacher-ng by far is not the most stable software!

>
> [1] https://bugs-devel.debian.org/cgi-bin/bugreport.cgi?bug=1074404
>
> >
> > Unfortunately, I didn't find the time to analyze why that was the
> > case.
> > I did a tcpdump during one of our builds, but didn't analyze it for 2
> > weeks or so :-(
> >
> > But I suspect either apt client sends a reload request or the expiry
> > date returned from upstream is to limited.
>
> It could also simply due to incorrect parsing of the expiry dates in apt-cacher-ng. Recently there were a lot of fixes regarding time parsing. Tricky to debug, though...
>
> > While this could be relevant when fetching packages from "main"
> > mirrors,
> > it should not have much impact on snapshot mirrors.
> >
> > To mitigate that issue, since then we switched to squid as a proxy for
> > snapshot.debian.org Squid has an offline mode, which says, no matter
> > what happens, cach entries once seen are never updated upstream. As
> > stated above, while this could have drastic impacts when using main
> > mirrors, it shouldn't cause issues on snapshots, by definition.
> >
> > Thus, I dropped apt-cacher-ng in our project in favour of squid.
> > I also prepared documentation for such, but during preparing the
> > patch, I was not sure if that is worth a separate doc/ file or if we
> > should merge that with doc/offline.md. I was struggling with that
> > decision since it does not really solve an offline case, as it only
> > caches packages already seen once, and further, only solves the
> > offline case for apt and not for other sources like git, ...
>
> Actually I'm more interested in having stable builds against snapshot.d.o, not so much in 100% offline builds. The situation upstream also got a bit better by rate-limiting on HTTP basis instead of TCP basis, so clients (including apt-cacher-ng and squid) should be able to correctly backoff. But I also did not check if the rate- limiting is implemented correctly, so that the client knows when to retry...

Stable builds is prio 1 for us.

But, also when using squid as a proxy ("non-offline mode") we experienced some troubles
with snapshot.d.o when downloading the index file [1]
Even though we were already caching most of the data, snapshot.debian.org denied
downloading that file, most probably because whole company network was blacklisted.

Thus, breaking our build, again.
That was the reason why we decided to go with squid's "offline-mode".

[1] http://snapshot.debian.org/archive/debian/20240904T000000Z/dists/bookworm/InRelease

>
> Anyways, we have a dilemma here: We need a stable baseline to build against (both due to product requirements, as well as for the SState cache). But currently it is REALLY hard to get this working in CI builds.
>
> >
> > What is your opinion?
>
> Probably we need both, until it is not clear which solution is long- term stable.
>
> Felix

BR Alexander

-- 
You received this message because you are subscribed to the Google Groups "isar-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to isar-users+unsubscribe@googlegroups.com.
To view this discussion visit https://groups.google.com/d/msgid/isar-users/AM7PR10MB3320312B8ADF79BE6B0ED21786552%40AM7PR10MB3320.EURPRD10.PROD.OUTLOOK.COM.