Before You Begin

This tutorial shows you how to create tag namespaces and defined tags in Oracle Cloud Infrastructure for use with PeopleSoft Cloud Manager. This tutorial takes approximately 10 minutes to complete.

You apply defined tags to resources in Cloud Manager, including templates and provisioned environments, to identity and organize your environments. You can use the tags to help you find and track your environments in Oracle Cloud Infrastructure. You can also specify tags as criteria when setting up policies for governance in Cloud Manager. 

Before a user can apply defined tags to Cloud Manager resources, an administrator sets up the tag namespace and tag keys in Oracle Cloud Infrastructure. Tag key is the name for the tag. The administrator defines the tag type and lists of values.

See Tagging in the Oracle Cloud Infrastructure documentation.

Background

This is the seventeenth tutorial in the Install PeopleSoft Cloud Manager series. Read the tutorials in the order listed. The optional tutorials offer alternate methods for setup.

Step 1: Create a Tag Namespace

Namespaces are essentially containers for defined tags. To create a tag namespace:

  1. As an administrator, sign in to Oracle Cloud Infrastructure and select Governance & Administration, then Tag Namespaces.
  2. Click Create Namespace Definition.
    Tag Namespaces page
    Description of this illustration (create_namespace_defn.png)
  3. Select a compartment.
  4. Enter a descriptive name, such as psft-finance. Enter a description.
    Create Namespace Definition page
    Description of this illustration (create_namespace_defn_name.png)
  5. Click Create Namespace Definition.

Step 2: Create a Defined Tag with a List of Values

To create a tag with a list of values:
  1. On the Tag Namespaces page, locate the namespace in the list and click the name to view details.
  2. Click Create Tag Key Definition.

    Tag Namespace Details page
    Description of this illustration (create_tag_key_defn.png)
  3. Enter a name and description for the tag key. The names are case-insensitive.
  4. Select the value type A list of values.
  5. In the Values field, enter values, separated by line feeds. The values are case-sensitive.
    Create Tag Key Definition with a list of values
    Description of this illustration (create_tag_key_list.png)
  6. Click Create Tag Key Definition.

Step 3: Create a Defined Tag with a Static Value

To create a tag with a static value:
  1. Locate the namespace from the list and click the name to view details.
  2. Click Create Tag Key Definition.
  3. Enter a name and description for the tag key.
  4. Select the type Static Value.
    Create Tag Key Definition with a static value
    Description of this illustration (create_tag_key_static.png)
  5. Click Create Tag Key Definition.

Step 4: Use Defined Tags in PeopleSoft Cloud Manager

The tags can be used by any end user:

  1. Sign in to PeopleSoft Cloud Manager.
  2. Click the Settings tile, and select Infrastructure Settings.
  3. Click Refresh OCI Metadata to bring in the namespace and tag definitions from Oracle Cloud Infrastructure.

When you create or update resources in Cloud Manager, you will be able to select from a list of available namespaces, defined tags, and values. Use defined tags with environment templates, provisioned environments, nodes, imported environments, and policies.

For tag keys with static values, you can input variables that are resolved at run time.The following variables are supported for Cloud Manager:

  • ${cloudmanager.env_name} — the name of the provisioned environment
  • ${cloudmanager.app_type} — the application type (HCM, FSCM, and so on)
  • ${cloudmanager.tools_ver} — the PeopleTools version
  • ${cloudmanager.app_ver} — the PeopleSoft application version

The Oracle Cloud Infrastructure supported variables include:

  • ${iam.principal.name} — the name of the principal that tagged the resource
  • ${iam.principal.type} — the type of principal that tagged the resource
  • ${oci.datetime} — the date and time that the resource was tagged

See Supported Tag Variables in the Oracle Cloud Infrastructure documentation.

Follow the instructions in the PeopleSoft Cloud Manager documentation to use tags. Select the PeopleSoft Cloud Manager page on the Oracle Help Center.

Next Steps

Create Data Science Resources for Auto Scaling in PeopleSoft Cloud Manager (Optional)

Learn More