az openshift

Reference

Manage Azure Red Hat OpenShift 3.11 clusters.

The az openshift command is deprecated and has been replaced by az aro for ARO 4 clusters. See http://aka.ms/aro/4 for information on switching to ARO 4.

Commands

az openshift create	Create a new Azure Red Hat OpenShift 3.11 cluster.
az openshift delete	Delete an Azure Red Hat OpenShift 3.11 cluster.
az openshift list	List Azure Red Hat OpenShift 3.11 clusters.
az openshift monitor	Commands to manage Log Analytics monitoring in an ARO 3.11 cluster.
az openshift monitor disable	Disable Log Analytics monitoring in an ARO 3.11 cluster.
az openshift monitor enable	Enable Log Analytics monitoring in an ARO 3.11 cluster.
az openshift scale	Scale the compute pool in an Azure Red Hat OpenShift 3.11 cluster.
az openshift show	Show the details for an Azure Red Hat OpenShift 3.11 cluster.
az openshift wait	Wait for an Azure Red Hat OpenShift 3.11 cluster to reach a desired state.

az openshift create

Create a new Azure Red Hat OpenShift 3.11 cluster.

Support for the creation of ARO 3.11 clusters ends 30 Nov 2020. Please see aka.ms/aro/4 for information on switching to ARO 4.

az openshift create --name
                    --resource-group
                    [--aad-client-app-id]
                    [--aad-client-app-secret]
                    [--aad-tenant-id]
                    [--compute-count]
                    [--compute-vm-size]
                    [--customer-admin-group-id]
                    [--location]
                    [--no-wait]
                    [--subnet-prefix]
                    [--tags]
                    [--vnet-peer]
                    [--vnet-prefix]
                    [--workspace-id]

Examples

Create an OpenShift cluster and auto create an AAD Client

az openshift create -g MyResourceGroup -n MyManagedCluster

Create an OpenShift cluster and auto create an AAD Client and setup cluster admin group

az openshift create -g MyResourceGroup -n MyManagedCluster --customer-admin-group-id {GROUP_ID}

Create an OpenShift cluster with 5 compute nodes and a custom AAD Client.

az openshift create -g MyResourceGroup -n MyManagedCluster --aad-client-app-id {APP_ID} --aad-client-app-secret {APP_SECRET} --aad-tenant-id {TENANT_ID} --compute-count 5

Create an Openshift cluster using a custom vnet

az openshift create -g MyResourceGroup -n MyManagedCluster --vnet-peer "/subscriptions/0000000-0000-0000-0000-000000000000/resourceGroups/openshift-vnet/providers/Microsoft.Network/virtualNetworks/test"

Create an Openshift cluster with Log Analytics monitoring enabled

az openshift create -g MyResourceGroup -n MyManagedCluster --workspace-id "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyResourceGroup/providers/Microsoft.OperationalInsights/workspaces/{workspace-id}"

Required Parameters

--name -n

Name of the managed OpenShift cluster.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

--aad-client-app-id

The ID of an Azure Active Directory client application. If not specified, a new Azure Active Directory client is created.

--aad-client-app-secret

The secret of an Azure Active Directory client application.

--aad-tenant-id

The ID of an Azure Active Directory tenant.

--compute-count -c

Number of nodes in the OpenShift node pool.

default value: 4

--compute-vm-size -s

Size of Virtual Machines to create as OpenShift nodes.

default value: Standard_D4s_v3

--customer-admin-group-id

The Object ID of an Azure Active Directory Group that memberships will get synced into the OpenShift group "osa-customer-admins". If not specified, no cluster admin access will be granted.

--location -l

Location. Values from: az account list-locations. You can configure the default location using az configure --defaults location=<location>.

--no-wait

Do not wait for the long-running operation to finish.

--subnet-prefix

The CIDR used on the Subnet into which to deploy the cluster.

default value: 10.0.0.0/24

--tags

Space-separated tags: key[=value] [key[=value] ...]. Use "" to clear existing tags.

--vnet-peer

The ID or the name of a subnet in an existing VNet into which to peer the cluster.

--vnet-prefix

The CIDR used on the VNet into which to deploy the cluster.

default value: 10.0.0.0/8

--workspace-id

The resource id of an existing Log Analytics Workspace to use for storing monitoring data.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az openshift delete

Delete an Azure Red Hat OpenShift 3.11 cluster.

The az openshift command is deprecated and has been replaced by az aro for ARO 4 clusters. See http://aka.ms/aro/4 for information on switching to ARO 4.

az openshift delete --name
                    --resource-group
                    [--no-wait]
                    [--yes]

Examples

Delete an Azure Red Hat OpenShift 3.11 cluster.

az openshift delete --name MyManagedOpenShiftCluster --resource-group MyResourceGroup

Required Parameters

--name -n

Name of the managed OpenShift cluster.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

--no-wait

Do not wait for the long-running operation to finish.

--yes -y

Do not prompt for confirmation.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az openshift list

List Azure Red Hat OpenShift 3.11 clusters.

The az openshift command is deprecated and has been replaced by az aro for ARO 4 clusters. See http://aka.ms/aro/4 for information on switching to ARO 4.

az openshift list [--resource-group]

Optional Parameters

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az openshift scale

Scale the compute pool in an Azure Red Hat OpenShift 3.11 cluster.

The az openshift command is deprecated and has been replaced by az aro for ARO 4 clusters. See http://aka.ms/aro/4 for information on switching to ARO 4.

az openshift scale --compute-count
                   --name
                   --resource-group
                   [--no-wait]

Examples

Scale the compute pool in an Azure Red Hat OpenShift 3.11 cluster.

az openshift scale --compute-count 5 --name MyManagedOpenShiftCluster --resource-group MyResourceGroup

Required Parameters

--compute-count -c

Number of nodes in the OpenShift compute pool.

default value: 4

--name -n

Name of the managed OpenShift cluster.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

--no-wait

Do not wait for the long-running operation to finish.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az openshift show

Show the details for an Azure Red Hat OpenShift 3.11 cluster.

Support for existing ARO 3.11 clusters ends June 2022. Please see aka.ms/aro/4 for information on switching to ARO 4.

az openshift show --name
                  --resource-group

Examples

Show the details for an Azure Red Hat OpenShift 3.11 cluster.

az openshift show --name MyManagedOpenShiftCluster --resource-group MyResourceGroup

Required Parameters

--name -n

Name of the managed OpenShift cluster.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az openshift wait

Wait for an Azure Red Hat OpenShift 3.11 cluster to reach a desired state.

The az openshift command is deprecated and has been replaced by az aro for ARO 4 clusters. See http://aka.ms/aro/4 for information on switching to ARO 4.

az openshift wait --name
                  --resource-group
                  [--created]
                  [--custom]
                  [--deleted]
                  [--exists]
                  [--interval]
                  [--timeout]
                  [--updated]

Examples

Wait for a cluster to be upgraded, polling every minute for up to thirty minutes.

az openshift wait -g MyResourceGroup -n MyManagedCluster --updated --interval 60 --timeout 1800

Required Parameters

--name -n

Name of the managed OpenShift cluster.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

--created

Wait until created with 'provisioningState' at 'Succeeded'.

--custom

Wait until the condition satisfies a custom JMESPath query. E.g. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Wait until deleted.

--exists

Wait until the resource exists.

--interval

Polling interval in seconds.

default value: 30

--timeout

Maximum wait in seconds.

default value: 3600

--updated

Wait until updated with provisioningState at 'Succeeded'.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az openshift

Is this page helpful?

Commands

az openshift create

Examples

Required Parameters

Optional Parameters

az openshift delete

Examples

Required Parameters

Optional Parameters

az openshift list

Optional Parameters

az openshift scale

Examples

Required Parameters

Optional Parameters

az openshift show

Examples

Required Parameters

az openshift wait

Examples

Required Parameters

Optional Parameters

الملاحظات