diff --git a/cluster/gce/gci/README.md b/cluster/gce/gci/README.md index 97ce5b50ea0..35c2007b437 100644 --- a/cluster/gce/gci/README.md +++ b/cluster/gce/gci/README.md @@ -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