https://github.com/cri-o/packaging
CRI-O deb and rpm packages.
https://github.com/cri-o/packaging
cri-o deb rpm
Last synced: 6 months ago
JSON representation
CRI-O deb and rpm packages.
- Host: GitHub
- URL: https://github.com/cri-o/packaging
- Owner: cri-o
- License: apache-2.0
- Created: 2023-09-18T18:34:08.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-05-17T06:40:46.000Z (over 1 year ago)
- Last Synced: 2024-05-18T03:22:48.373Z (over 1 year ago)
- Topics: cri-o, deb, rpm
- Language: Shell
- Homepage: https://cri-o.io
- Size: 254 KB
- Stars: 13
- Watchers: 10
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# CRI-O Packaging
[](https://github.com/cri-o/packaging/actions/workflows/obs.yml)
[](https://github.com/cri-o/packaging/actions/workflows/obs.yml)
[](https://github.com/cri-o/packaging/actions/workflows/schedule.yml)
[](https://github.com/cri-o/packaging/actions/workflows/test.yml)
The intention of this project is to encapsulate CRI-O's packaging efforts into a
dedicated repository, following official Kubernetes guidelines by using the
[openSUSE Build Service (OBS)](https://build.opensuse.org).
- [Project Layout](#project-layout)
- [Stable Versions](#stable-versions)
- [Prereleases](#prereleases)
- [Usage](#usage)
- [Available Streams](#available-streams)
- [Stable](#stable)
- [Deprecated](#deprecated)
- [Prerelease](#prerelease)
- [Deprecated](#deprecated-1)
- [Define the Kubernetes version and used CRI-O stream](#define-the-kubernetes-version-and-used-cri-o-stream)
- [Distributions using rpm packages](#distributions-using-rpm-packages)
- [Add the Kubernetes repository](#add-the-kubernetes-repository)
- [Add the CRI-O repository](#add-the-cri-o-repository)
- [Install package dependencies from the official repositories](#install-package-dependencies-from-the-official-repositories)
- [Install the packages](#install-the-packages)
- [Configure a Container Network Interface (CNI) plugin](#configure-a-container-network-interface-cni-plugin)
- [Start CRI-O](#start-cri-o)
- [Bootstrap a cluster](#bootstrap-a-cluster)
- [Distributions using deb packages](#distributions-using-deb-packages)
- [Install the dependencies for adding repositories](#install-the-dependencies-for-adding-repositories)
- [Add the Kubernetes repository](#add-the-kubernetes-repository-1)
- [Add the CRI-O repository](#add-the-cri-o-repository-1)
- [Install the packages](#install-the-packages-1)
- [Start CRI-O](#start-cri-o-1)
- [Bootstrap a cluster](#bootstrap-a-cluster-1)
- [Publishing](#publishing)
- [Using the static binary bundles directly](#using-the-static-binary-bundles-directly)
- [More to read](#more-to-read)
## Project Layout
CRI-O uses the same basic layout in OBS as Kubernetes project [`isv:kubernetes`](https://build.opensuse.org/project/show/isv:kubernetes),
but lives in a dedicated umbrella project called [`isv:cri-o`](https://build.opensuse.org/project/show/isv:cri-o).
This project contains a bunch of other [subprojects](https://build.opensuse.org/project/subprojects/isv:cri-o).
> [!CAUTION]
> We switched from `https://pkgs.k8s.io/addons:/cri-o` to a new subproject
> `https://download.opensuse.org/repositories/isv:/cri-o` to work independently
> from the pkgs.k8s.io CDN. Please switch over if you haven't already (see the
> examples below).
### Stable Versions
- [`isv:cri-o:stable`](https://build.opensuse.org/project/show/isv:cri-o:stable): Stable Packages (Umbrella)
- [`isv:cri-o:stable:v1.33`](https://build.opensuse.org/project/show/isv:cri-o:stable:v1.33): `v1.33.z` tags (Stable)
- [`isv:cri-o:stable:v1.33:build`](https://build.opensuse.org/project/show/isv:cri-o:stable:v1.33:build): `v1.33.z` tags (Builder)
- [`isv:cri-o:stable:v1.32`](https://build.opensuse.org/project/show/isv:cri-o:stable:v1.32): `v1.32.z` tags (Stable)
- [`isv:cri-o:stable:v1.32:build`](https://build.opensuse.org/project/show/isv:cri-o:stable:v1.32:build): `v1.32.z` tags (Builder)
- [`isv:cri-o:stable:v1.31`](https://build.opensuse.org/project/show/isv:cri-o:stable:v1.31): `v1.31.z` tags (Stable)
- [`isv:cri-o:stable:v1.31:build`](https://build.opensuse.org/project/show/isv:cri-o:stable:v1.31:build): `v1.31.z` tags (Builder)
- [`isv:cri-o:stable:v1.30`](https://build.opensuse.org/project/show/isv:cri-o:stable:v1.30): `v1.30.z` tags (Stable)
- [`isv:cri-o:stable:v1.30:build`](https://build.opensuse.org/project/show/isv:cri-o:stable:v1.30:build): `v1.30.z` tags (Builder)
- **End of life:**
- [`isv:cri-o:stable:v1.29`](https://build.opensuse.org/project/show/isv:cri-o:stable:v1.29): `v1.29.z` tags (Stable)
- [`isv:cri-o:stable:v1.29:build`](https://build.opensuse.org/project/show/isv:cri-o:stable:v1.29:build): `v1.29.z` tags (Builder)
- [`isv:cri-o:stable:v1.28`](https://build.opensuse.org/project/show/isv:cri-o:stable:v1.28): `v1.28.z` tags (Stable)
- [`isv:cri-o:stable:v1.28:build`](https://build.opensuse.org/project/show/isv:cri-o:stable:v1.28:build): `v1.28.z` tags (Builder)
### Prereleases
- [`isv:cri-o:prerelease`](https://build.opensuse.org/project/show/isv:cri-o:prerelease): Prerelease Packages (Umbrella)
- [`isv:cri-o:prerelease:main`](https://build.opensuse.org/project/show/isv:cri-o:prerelease:main): [`main`](https://github.com/cri-o/cri-o/commits/main) branch (Prerelease)
- [`isv:cri-o:prerelease:main:build`](https://build.opensuse.org/project/show/isv:cri-o:prerelease:main:build): [`main`](https://github.com/cri-o/cri-o/commits/main) branch (Builder)
- [`isv:cri-o:prerelease:v1.33`](https://build.opensuse.org/project/show/isv:cri-o:prerelease:v1.33): [`release-1.33`](https://github.com/cri-o/cri-o/commits/release-1.33) branch (Prerelease)
- [`isv:cri-o:prerelease:v1.33:build`](https://build.opensuse.org/project/show/isv:cri-o:prerelease:v1.33:build): [`release-1.33`](https://github.com/cri-o/cri-o/commits/release-1.33) branch (Builder)
- [`isv:cri-o:prerelease:v1.32`](https://build.opensuse.org/project/show/isv:cri-o:prerelease:v1.32): [`release-1.32`](https://github.com/cri-o/cri-o/commits/release-1.32) branch (Prerelease)
- [`isv:cri-o:prerelease:v1.32:build`](https://build.opensuse.org/project/show/isv:cri-o:prerelease:v1.32:build): [`release-1.32`](https://github.com/cri-o/cri-o/commits/release-1.32) branch (Builder)
- [`isv:cri-o:prerelease:v1.31`](https://build.opensuse.org/project/show/isv:cri-o:prerelease:v1.31): [`release-1.31`](https://github.com/cri-o/cri-o/commits/release-1.31) branch (Prerelease)
- [`isv:cri-o:prerelease:v1.31:build`](https://build.opensuse.org/project/show/isv:cri-o:prerelease:v1.31:build): [`release-1.31`](https://github.com/cri-o/cri-o/commits/release-1.31) branch (Builder)
- [`isv:cri-o:prerelease:v1.30`](https://build.opensuse.org/project/show/isv:cri-o:prerelease:v1.30): [`release-1.30`](https://github.com/cri-o/cri-o/commits/release-1.30) branch (Prerelease)
- [`isv:cri-o:prerelease:v1.30:build`](https://build.opensuse.org/project/show/isv:cri-o:prerelease:v1.30:build): [`release-1.30`](https://github.com/cri-o/cri-o/commits/release-1.30) branch (Builder)
- **End of life:**
- [`isv:cri-o:prerelease:v1.29`](https://build.opensuse.org/project/show/isv:cri-o:prerelease:v1.29): [`release-1.29`](https://github.com/cri-o/cri-o/commits/release-1.29) branch (Prerelease)
- [`isv:cri-o:prerelease:v1.29:build`](https://build.opensuse.org/project/show/isv:cri-o:prerelease:v1.29:build): [`release-1.29`](https://github.com/cri-o/cri-o/commits/release-1.29) branch (Builder)
- [`isv:cri-o:prerelease:v1.28`](https://build.opensuse.org/project/show/isv:cri-o:prerelease:v1.28): [`release-1.28`](https://github.com/cri-o/cri-o/commits/release-1.28) branch (Prerelease)
- [`isv:cri-o:prerelease:v1.28:build`](https://build.opensuse.org/project/show/isv:cri-o:prerelease:v1.28:build): [`release-1.28`](https://github.com/cri-o/cri-o/commits/release-1.28) branch (Builder)
The `prerelease` projects are mainly used for `release-x.y` branches as well as
the `main` branch of CRI-O. The `stable` projects are used for tagged releases.
The `build` projects are the builders for each project to be published, while
the main repositories for them are on top. For example, the builder project for
`main` is:
- `isv:cri-o:prerelease:main:build`
But end-users will consume:
- `isv:cri-o:prerelease:main`
All packages are based on the static binary bundles provided by the CRI-O CI.
## Usage
### Available Streams
#### Stable
[](https://build.opensuse.org/project/show/isv:cri-o:stable:v1.33)
[](https://build.opensuse.org/project/show/isv:cri-o:stable:v1.32)
[](https://build.opensuse.org/project/show/isv:cri-o:stable:v1.31)
[](https://build.opensuse.org/project/show/isv:cri-o:stable:v1.30)
##### Deprecated
[](https://build.opensuse.org/project/show/isv:cri-o:stable:v1.29)
[](https://build.opensuse.org/project/show/isv:cri-o:stable:v1.28)
#### Prerelease
[](https://build.opensuse.org/project/show/isv:cri-o:prerelease:main)
[](https://build.opensuse.org/project/show/isv:cri-o:prerelease:v1.33)
[](https://build.opensuse.org/project/show/isv:cri-o:prerelease:v1.32)
[](https://build.opensuse.org/project/show/isv:cri-o:prerelease:v1.31)
[](https://build.opensuse.org/project/show/isv:cri-o:prerelease:v1.30)
##### Deprecated
[](https://build.opensuse.org/project/show/isv:cri-o:prerelease:v1.29)
[](https://build.opensuse.org/project/show/isv:cri-o:prerelease:v1.28)
#### Define the Kubernetes version and used CRI-O stream
```bash
KUBERNETES_VERSION=v1.32
CRIO_VERSION=v1.32
```
### Distributions using `rpm` packages
#### Add the Kubernetes repository
```bash
cat < curl https://raw.githubusercontent.com/cri-o/packaging/main/get | bash
```
The script automatically verifies the uploaded sigstore signatures as well, if
the local system has [`cosign`](https://github.com/sigstore/cosign) available in
its `$PATH`. The same applies to the [SPDX](https://spdx.org) based bill of
materials (SBOM), which gets automatically verified if the
[bom](https://sigs.k8s.io/bom) tool is in `$PATH`.
Besides `amd64`, we also support the `arm64`, `ppc64le` and `s390x` bit
architectures. This can be selected via the script, too:
```shell
curl https://raw.githubusercontent.com/cri-o/packaging/main/get | bash -s -- -a arm64
```
It is also possible to select a specific git SHA or tag by:
```shell
curl https://raw.githubusercontent.com/cri-o/packaging/main/get | bash -s -- -t v1.32.0
```
The above script resolves to the download URL of the static binary bundle
tarball matching the format:
```text
https://storage.googleapis.com/cri-o/artifacts/cri-o.$ARCH.$REV.tar.gz
```
Where `$ARCH` can be `amd64`, `arm64`, `ppc64le` or `s390x` and `$REV`
can be any git SHA or tag.
We also provide a Software Bill of Materials (SBOM) in the [SPDX
format](https://spdx.org) for each bundle. The SBOM is available at the same URL
like the bundle itself, but suffixed with `.spdx`:
```text
https://storage.googleapis.com/cri-o/artifacts/cri-o.$ARCH.$REV.tar.gz.spdx
```
## More to read
The following resources are great to understand the motivation behind the latest
`deb` and `rpm` packaging efforts within the CRI-O and Kubernetes community:
- **CRI-O is moving towards pkgs.k8s.io**:
https://k8s.io/blog/2023/10/10/cri-o-community-package-infrastructure
- **Kubernetes Legacy Package Repositories Will Be Frozen On September 13, 2023**:
https://kubernetes.io/blog/2023/08/31/legacy-package-repository-deprecation/
- **pkgs.k8s.io: Introducing Kubernetes Community-Owned Package Repositories**:
https://kubernetes.io/blog/2023/08/15/pkgs-k8s-io-introduction/
- **Installing Kubernetes via `kubeadm`**:
https://kubernetes.io/docs/setup/production-environment/tools/kubeadm/install-kubeadm/#dpkg-k8s-package-repo