github/kubernetes
1
0
Fork 0
mirror of https://github.com/k3s-io/kubernetes.git synced 2025-07-21 19:01:49 +00:00
Code Issues Projects Releases Wiki Activity

Merge pull request #91854 from bsdnet/gci

Browse Source 
Update the COS E2E image policy
This commit is contained in:
Kubernetes Prow Robot 2020-07-02 06:41:15 -07:00 committed by GitHub
commit c430183fff
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 73 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

79
cluster/gce/gci/README.md
View File

@ -21,14 +21,75 @@ Policy](https://cloud.google.com/container-optimized-os/docs/resources/support-p
Container-Optimized OS images are used by kubernetes [End-to-End tests](https://github.com/kubernetes/community/blob/master/contributors/devel/sig-testing/e2e-tests.md) and
[Node End-to-End tests](https://github.com/kubernetes/community/tree/master/contributors/devel/sig-node). To see current
active releases, please refer to COS's [Release
Notes](https://cloud.google.com/container-optimized-os/docs/release-notes). When
choose images for testing, the latest LTS images is suggested for running
presubmit, postsubmit or periodics tests since the image is stable and has
latest bug and security fixes. For testing requiring new features or continuous integration,
the latest dev or beta or stable channel can be used.
are needed, the latest LTS images or stables are preferred.
Notes](https://cloud.google.com/container-optimized-os/docs/release-notes).
### How to choose an image in configuration file
There are three ways to specify an image used by each testing suite: `image`,
`image_regex` or `image_family`.
* `image` is preferred, but manual updates are needed to use a newly released
COS image, so the test suites don't use deprecated images. This will result
to frequent yaml configuration file update everytime COS releases new
image.One future option is to use an autobumper robot to update COS image
automatically. e.g:
```
cos-stable:
image: cos-77-12371-274-0
project: cos-cloud
metadata: "user-data</go/src/github.com/containerd/cri/test/e2e_node/init.yaml,containerd-configure-sh</go/src/github.com/containerd/cri/cluster/gce/configure.sh,containerd-extra-init-sh</go/src/github.com/containerd/cri/test/e2e_node/gci-init.sh,containerd-env</workspace/test-infra/jobs/e2e_node/containerd/cri-master/env,gci-update-strategy=update_disabled"
```
* `image_family` should be used if you always want to use latest image in the
same family. Tests will start to use new images once COS releases
new image. This is not predictable and test can potentially be broken becase of this. The probability of a
breakage due to the OS itself is low for LTS or stable image, but high for dev or beta image.
If things went wrong, it will be hard to rollback
images using `image_regex` and `image_family`. e.g:
```
cos-stable:
image_family: cos-77-lts
project: cos-cloud
metadata: "user-data</workspace/test-infra/jobs/e2e_node/containerd/init.yaml,cni-template</workspace/test-infra/jobs/e2e_node/containerd/cni.template,containerd-config</workspace/test-infra/jobs/e2e_node/containerd/config.toml"
```
* `image_regex` can also
be used if you want image with the same naming pattern. Latest image will be
chosen when multiple images match the regular expression. However, this
option is rarely seen in the test code.
* To update the images, using image in the same channel is preferred. Keep in
mind, 69 is the first LTS image. Before that, COS only has dev, beta and stable
images. That is why stable images are used quite frequently in current testing.
For now, images should slowly migrate from stable to LTS if possible. For
testing using dev or beta, we need to consider the original intention and
keep using image in existing channel unless we understand the underlying reason.
### What image is needed for your test
Consider the importance of tests and the stability of Container-Optimized OS, the
following guidelines are proposed for image choice in E2E testing.
* To run release blocking tests, the latest LTS images are preferred.
'image' should be used to specify the image.
* To run presubmit, postsubmit or periodic tests, the latest LTS images are
preferred. If tests need two images, you can use the latest two LTS images.
LTS images are stable and usually include latest bug and security fix.
'image' should be used to specify the image.
* To integrate continuously with other container
related technologies like runc, containerd, docker and kubernertes, the
latest LTS or stable images are preferred. 'image_family' should be used to
specify the image.
* To try out latest COS features, the latest dev or beta or stable images are preferred.
'image' or 'image_family' should be used to specify the image.
### How to find current COS image in each channel
To find the current COS image, use the following command:
```shell
$ gcloud compute images list --project=cos-cloud |grep cos-cloud
cos-69-10895-385-0 cos-cloud cos-69-lts READY
@ -40,4 +101,10 @@ cos-dev-84-13078-0-0 cos-cloud cos-dev
cos-stable-81-12871-119-0 cos-cloud cos-stable READY
```
COS image will experience dev, beta, stable and LTS stage. Before LTS stage, image is named with its
family as a prefix, e.g cos-dev, cos-beta, cos-stable. However, the milestone
number in those families may change when channel promotions happen. Only when a milestone becomes LTS, the
image will have a new family, and the milestone number in the image name stays the same. The image
will be always there even after the milestone is deprecated.
[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/cluster/gce/gci/README.md?pixel)]()