Workflow: openshift-upgrade-azure-single-node

The Openshift E2E Azure single node workflow executes the upgrade end-to-end test suite on Azure with a default single-node cluster configuration and Loki as log collector, exercising an upgrade during the process.

Pre Steps

Name Description
ipi-install-hosted-loki The IPI install loki step deploys logging solution for collecting container logs and sending those to Loki hosted on Grafana Cloud.
ipi-conf-azure The IPI Azure configure step generates the Azure-specific install-config.yaml contents based on the cluster profile and optional input files.
single-node-conf-azure Modifies install-config.yaml to use a single control-plane node and without any workers.
ipi-install-stableinitial The IPI install-stableinitial step chain contains all the individual steps necessary to install an OpenShift cluster from stable-initial imagestream stream.

Test Steps

Name Description
single-node-e2e-test The Openshift E2E step executes the common end-to-end test suite.

Post Steps

Name Description
gather-network The network step runs the must gather network tool to gather network artifacts.
gather-core-dump The network step runs the must gather network tool to gather core dumps.
ipi-azure-post The IPI cleanup step contains all steps that deprovision an OpenShift cluster on Azure, provisioned by the `ipi-azure-pre` chain.

Dependencies

Image Exposed As Override[?] Required By Steps
release:initial OPENSHIFT_INSTALL_RELEASE_IMAGE_OVERRIDE yes ipi-install-install-stableinitial
release:latest OPENSHIFT_UPGRADE_RELEASE_IMAGE_OVERRIDE yes single-node-e2e-test
RELEASE_IMAGE_LATEST no ipi-install-install-stableinitial

Environment

In addition to the default environment, the following variables are consumed through this workflow

Variable Name Variable Content Consumed By Steps
ARM64_RELEASE_OVERRIDE Hack to pass the release override for ARM64 tests. ipi-install-install-stableinitial
BASE_DOMAIN This value represents the the DNS zone that is configured in the azure portal, and it will be used in the base_domain field of the install-config.yaml file. (default: ci.azure.devcluster.openshift.com) ipi-conf-azure
COMPUTE_NODE_TYPE The instance type to use for compute nodes (default: Standard_D4s_v3) ipi-conf-azure
FIPS_ENABLED (default: false) ipi-conf
OPENSHIFT_INSTALL_EXPERIMENTAL_DUAL_STACK Using experimental Azure dual-stack support (default: false) ipi-install-install-stableinitial
SIZE_VARIANT The size of the cluster in one of our supported t-shirt values that is standard across all CI environments. The sizes are: * "" (default) - 4 vCPU, 16GB control plane nodes, default workers * "compact" - 8 vCPU, 32GB control plane nodes, no workers * "large" - 16 vCPU, 64GB+ control plane nodes, default workers, suitable for clusters up to 250 nodes * "xlarge" - 32 vCPU, 128GB+ control plane nodes, default workers, suitable for clusters up to 1000 nodes These sizes are roughly consistent across all cloud providers, but we may not be able to instantiate some sizes in some regions or accounts due to quota issues. ipi-conf-azure
TEST_ARGS Additional arguments to be passed to 'openshift-test' single-node-e2e-test
TEST_CSI_DRIVER_MANIFEST Name of the CSI driver manifest file to use. Used by the `openshift-tests` program as TEST_CSI_DRIVER_FILES env. var., see its documentation for details. The file must be present in ${SHARED_DIR}. single-node-e2e-test
TEST_INSTALL_CSI_DRIVERS The CSI driver(s) to use. Used by the `openshift-tests` program, see its documentation for details. single-node-e2e-test
TEST_REQUIRES_SSH If the test suite requires SSH access, setting this variable will install a bastion and configure the Kube e2e test infrastructure to use the bastion. Otherwise, tests that require SSH will fail because OpenShift does not expose SSH to nodes by default. single-node-e2e-test
TEST_SKIPS Regular expression (POSIX basic regular expression) of tests to skip. single-node-e2e-test
TEST_SUITE The test suite to run. Use 'openshift-test run --help' to list available suites. (default: openshift/conformance/parallel) single-node-e2e-test
TEST_TYPE The type of test to perform. * 'suite' - Run the test suite defined by TEST_SUITE. By default this executes the OpenShift parallel conformance suite. All product components must run the default suite on pull requests prior to merge. * 'suite-conformance' - Runs the test suite defined by TEST_SUITE, then runs the product conformance suite to verify the cluster is still functional. This is typically used for testing disruption from one suite, then confirming that the disruption did not degrade the product. * 'upgrade' - Perform an upgrade to the image defined by OPENSHIFT_UPGRADE_RELEASE_IMAGE_OVERRIDE. The TEST_UPGRADE_OPTIONS flag may be optionally set. All product components must run the default upgrade test (verify an upgrade completes) on pull requests prior to merge. * 'upgrade-conformance' - Performs the 'upgrade' test and then executes the full conformance suite after upgrade completes. Does not honor TEST_SUITE but will respect TEST_UPGRADE_OPTIONS. All product releases must pass the conformance suite after an upgrade completes or have explicit logic in their test to tolerate behavior after upgrade. * 'upgrade-paused' - Perform an upgrade to the images defined by OPENSHIFT_UPGRADE_RELEASE_IMAGE_OVERRIDE with paused worker pool. (default: suite) single-node-e2e-test
TEST_UPGRADE_OPTIONS Options controlling how an upgrade is performed. See `openshift-test run-upgrade --help` for more details. single-node-e2e-test
TEST_UPGRADE_SUITE The test suite to run in upgrade tests. Use 'openshift-test run --help' to list available suites. (default: all) single-node-e2e-test

Step Graph

Webreg Workflow "openshift-upgrade-azure-single-node" cluster_2 Pre cluster_0 ipi-conf-azure cluster_1 ipi-install-stableinitial cluster_3 Test cluster_9 Post cluster_4 gather-network cluster_5 gather-core-dump cluster_8 ipi-azure-post cluster_7 ipi-deprovision cluster_6 gather 0 ipi-install-hosted-loki 1 ipi-conf 0->1 2 ipi-conf-azure 1->2 3 ipi-install-monitoringpvc 2->3 4 single-node-conf-azure 3->4 5 ipi-install-rbac 4->5 6 ipi-install-install-stableinitial 5->6 7 single-node-e2e-test 6->7 8 gather-network 7->8 9 gather-core-dump 8->9 10 gather-must-gather 9->10 11 gather-extra 10->11 12 gather-audit-logs 11->12 13 ipi-deprovision-deprovision 12->13

GitHub Link:

https://github.com/openshift/release/blob/master/ci-operator/step-registry/openshift/upgrade/azure/single-node/openshift-upgrade-azure-single-node-workflow.yaml

Owners:

Approvers:

Source code for this page located on GitHub