Merge pull request #1610 from SUSE/for-deploy-6

🤖: Update build recipes for SP6

sles15-image/README.md

@@ -4,27 +4,70 @@
 
 ## Description
 
-SUSE Linux Enterprise Base Container Images (SLE BCI) provide truly open,
-flexible, and secure container images and application development tools. The
-images consist of container environments based on SUSE Linux Enterprise and
-designed to be a secure base for any containerized workload.
-
-SLE BCI is freely available, re-distributable, and supported across many
-different environments. These templates and tools address modern, containerized
-application development and CI/CD application containerization.  They can be
-used immediately by developers and integrators without the “lock-in” imposed by
-other offerings.
-
-SLE BCI inherits industry-leading security and compliance from SUSE Linux
-within your container build process. The container images are designed to be a
-secure base for any application workload. SUSE ensures that compliance
-standards are applied consistently and continuously improves security-related
-capabilities.
-
-SLE BCI is lightweight and easy to adopt, with the ability to run with any
-Linux OS. Avoid lock-in imposed by other vendors and get exactly what you need,
-fast. SLE BCI delivers a flexible developer experience that accounts for,
-integrates with, and supports language-native tools and workflows.
+SUSE Linux Enterprise Base Container Images (SLE BCI) provide open, flexible,
+and secure container images. The images include container environments based on
+SUSE Linux Enterprise Server and are available at no cost, they can be freely
+re-distributed, and they are supported across different environments.
+
+The Base Container Image is an image used as a foundation for most SLE BCIs. The
+image is intended to be extended for further use, such as a development or a
+testing environment.
+
+
+## Usage
+
+The container image comes with the `zypper` package manager, the free `SLE_BCI`
+repository and the `container-suseconnect` utility. This allows you to access to
+the full SLE repositories with a valid SLE subscription. The image is designed
+to be extended by installing packages required for your specific scenario.
+
+To build a custom image using a `Containerfile` that includes the
+[`skopeo`](https://github.com/containers/skopeo) utility, create the following
+`Containerfile`:
+```Dockerfile
+FROM registry.suse.com/bci/bci-base:15.6
+RUN set -euo pipefail; \
+    zypper -n ref; \
+    zypper -n in skopeo; \
+    zypper -n clean; \
+    rm -rf /var/log/{lastlog,tallylog,zypper.log,zypp/history,YaST2}
+```
+
+Then build the container using `buildah`:
+```bash
+buildah bud -t bci-skopeo .
+```
+
+The image can also be used interactively to create a container with skopeo
+installed in it:
+```ShellSession
+$ podman run -ti --rm registry.suse.com/bci/bci-base:15.6
+# zypper -n in skopeo
+...
+# skopeo inspect -f "{{ .Name }}" docker://registry.suse.com/bci/bci-base:15.6
+registry.suse.com/bci/bci-base
+```
+
+### The SLE_BCI repository
+
+The container image comes with the free `SLE_BCI` repository. The repository
+contains a subset of all packages from SUSE Linux Enterprise. The packages are
+available free of charge, and they can be redistributed freely. However, they
+are provided without support. The repository also contains the latest version of
+packages only.
+
+
+### Getting access to the SLE repositories
+
+The `container-suseconnect` utility in the image can automatically add the full
+SUSE Linux Enterprise repositories into the running container if you have a
+valid SLE subscription.
+
+Find more information about container-suseconnect in the
+[`container-suseconnect`](https://documentation.suse.com/container/all/single-html/Container-guide/index.html#sec-container-suseconnect)
+section in the container guide or in the tutorial ["How to use
+container-suseconnect"](https://opensource.suse.com/bci-docs/guides/container-suseconnect/).
+
 
 ## Licensing
 

sles15-image/sles15-image.changes

@@ -1,3 +1,8 @@
+-------------------------------------------------------------------
+Fri Sep  6 09:29:43 UTC 2024 - Dan Čermák <dcermak@suse.com>
+
+- update / extend README
+
 -------------------------------------------------------------------
 Tue Aug 20 10:08:00 UTC 2024 - Dirk Mueller <dmueller@suse.com>