Oracle Cloud Infrastructure Documentation

Creating OraclePCA Tags

Private Cloud Appliance uses the OraclePCA tag namespace to set attributes that aren't available as OCI CLI options or API attributes. For OKE, some cluster attributes must be set by using OraclePCA tags.

Other attributes that can only be set by using OraclePCA tags, such as some block volume and file system attributes, are documented in Using Resource Tags to Extend Functionality (IAM on the Appliance). You might want to set some of these for nodes in a node pool.

When you use the OCI CLI or API, you can specify the OraclePCA tag namespace, tag key, and values for the attributes that you want to set. You don't need to first create the OraclePCA tag namespace and tag keys.

To use the OCI CLI to set these attributes, you must first create the OraclePCA tag namespace, tag keys, and value choices.

CAUTION

Don't delete these tag keys. Don't create this tag namespace and these keys unless you need to use the OCI CLI to create clusters. If you create this tag namespace and these keys, create them exactly as shown here, don't modify them, and don't delete them.

The following sections describe how to create the OraclePCA tag namespace, and how to create the tag key definitions for the OKE attributes.

Creating the OraclePCA Tag Namespace

  1. In the Compute Web UI navigation menu, select Governance, and then select Tag Namespaces.

    Ensure that the compartment that's selected in the compartment drop-down menu above the tag namespaces list is the compartment where you want to create the OraclePCA tag namespace.

  2. If OraclePCA isn't shown in the Tag Namespaces list, select Create Namespace Definitions.

  3. In the Create Namespace Definition dialog box, scroll down to the Tagging section and click in the Tag Namespace field.

    • If the OraclePCA tag namespace isn't listed, continue with Step 4 of this procedure.

    • If the tag you need is already available, select Cancel. You get an error message if you try to create this tag namespace when it's already available.

  4. In Create Namespace Definition, enter the following information:

    • Namespace Definition Name: Enter "OraclePCA".

    • Description: For example, "Support block volume, cluster, and file system parameters that are only available on Private Cloud Appliance."

  5. Select Create Namespace Definition.

    The details page for the new OraclePCA tag namespace definition is displayed.

Creating the OraclePCA Tag Key Definitions

  1. Navigate to the OraclePCA tag namespace details page, under Resources, and select Tag Key Definitions.

  2. If the tag key you need isn't listed, select Create Tag Key Definition.

  3. In the Create Tag Key Definition dialog box, enter the following information for the tag key that you're creating.

    SSH Key

    • Name: Enter "sshkey".

    • Description: For example, "Your public SSH key."

    • Tag Value Type: Select "Static Value".

    Number of Control Plane Nodes

    • Name: Enter "cpNodeCount".

    • Description: For example, "Number of nodes in the control plane."

    • Tag Value Type: Select "A List of Values".

    • Values: Enter "1", newline, "3", newline, and "5".

    Shape of Control Plane Nodes

    • Name: Enter "cpNodeShape".

    • Description: For example, "The shape of the control plane nodes."

    • Tag Value Type: Select "Static Value".

    Shape Configuration of Control Plane Nodes

    • Name: Enter "cpNodeShapeConfig".

    • Description: For example, "The number of OCPUs and optionally amount of memory for a flexible node shape."

    • Tag Value Type: Select "Static Value".

  4. Select Create Tag Key Definition.