Soon, all Red Hat OpenShift documentation will only be available on docs.redhat.com, the official location of all Red Hat product documentation. Get familiar with the updated experience today!
  1. Documentation
×

Destroying a hosted cluster on AWS

You can destroy a hosted cluster and its managed cluster resource on Amazon Web Services (AWS) by using the command-line interface (CLI).

Destroying a hosted cluster on AWS by using the CLI

You can use the command-line interface (CLI) to destroy a hosted cluster on Amazon Web Services (AWS).

Procedure

  1. Delete the managed cluster resource on multicluster engine Operator by running the following command:

    $ oc delete managedcluster <hosted_cluster_name> (1)
    1 Replace <hosted_cluster_name> with the name of your cluster.

  2. Delete the hosted cluster and its backend resources by running the following command:

    $ hcp destroy cluster aws  \
  --name <hosted_cluster_name> \(1)
  --infra-id <infra_id> \(2)
  --role-arn <arn_role> \(3)
  --sts-creds <path_to_sts_credential_file> \(4)
  --base-domain <basedomain> (5)
    1 Specify the name of your hosted cluster, for instance, example.
    2 Specify the infrastructure name for your hosted cluster.
    3 Specify the Amazon Resource Name (ARN), for example, arn:aws:iam::820196288204:role/myrole.
    4 Specify the path to your AWS Security Token Service (STS) credentials file, for example, /home/user/sts-creds/sts-creds.json.
    5 Specify your base domain, for example, example.com.

    If your session token for AWS Security Token Service (STS) is expired, retrieve the STS credentials in a JSON file named sts-creds.json by running the following command:

    $ aws sts get-session-token --output json > sts-creds.json