Creating OraclePCA Tags

Oracle Private Cloud Appliance uses the OraclePCA tag namespace to set attributes that are not 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 the Oracle Private Cloud Appliance User Guide. 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 do not need to first create the OraclePCA tag namespace and tag keys.

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

Caution:

Do not delete these tag keys. Do not create this tag namespace and these keys unless you need to use the Compute Web UI to create clusters. If you create this tag namespace and these keys, create them exactly as shown here, do not modify them, and do not 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 navigation menu, select Governance, and then select Tag Namespaces.

    Ensure that the compartment that is 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 is not shown in the Tag Namespaces list, select the Create Namespace Definitions button.

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

    • If the OraclePCA tag namespace is not listed, continue with Step 4 of this procedure.

    • If the tag you need is already available, select the Cancel button in the Create Namespace Definition dialog. You will get an error message if you try to create this tag namespace when it is already available.

  4. In the Create Namespace Definition window, 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, scroll down to the Resources box, and select Tag Key Definitions.

  2. If the tag key you need is not listed, select the Create Tag Key Definition button.

  3. In the Create Tag Key Definition dialog, enter the following information for the tag key that you are 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.