Oracle Cloud Infrastructure Documentation

Promoting a Versioned Custom Software Source to a Lifecycle Stage

Promote the content in a versioned custom software source in OS Management Hub to provide that content to all instances assigned to a lifecycle stage.

When promotion occurs, the service:

  • Detaches previously attached software sources from the instance.
  • Attaches the versioned custom software source associated with the lifecycle stage to the instance.
  • Installs all the packages and modules in the attached versioned custom software source to the instance.

See also:

    1. Open the navigation menu and click Observability & Management. Under OS Management Hub, click Lifecycle environments.
    2. Under List scope, select the compartment that contains the lifecycle environment you're interested in.
    3. Click the name of the lifecycle environment.
    4. Select the stage in the list.
    5. Click Promote content.
    6. Enter the details for the promotion:

      Name: Enter a name for the job. The name doesn't need to be unique, because an Oracle Cloud Identifier (OCID) uniquely identifies the instance. Avoid entering confidential information.

      Description: (Optional) Enter a description for the job. Avoid entering confidential information.

      If promoting to the first stage, select the Versioned custom software source:

      1. Compartment: Select the compartment that contains the software source.
      2. Select the software source from the list.

      Schedule: Choose when to run the job.

      • Run immediately: Select this option to run the job now.
      • Schedule: Select this option to run the job at a future date and time. Click the calendar icon to select a date and time.
        • Automatic Retry: When selected, if the initial execution of the job fails, the service retries the job up three times. Each retry is five minutes apart.

        • Show advanced options: Click to add tags to this resource.

          If you have permissions to create a resource, then you also have permissions to apply free-form tags to that resource. To apply a defined tag, you must have permissions to use the tag namespace. For more information about tagging, see Resource Tags. If you're not sure whether to apply tags, ask an administrator or skip this option. You can apply tags later.

    7. Click Promote.

  • Use the oci os-management-hub lifecycle-stage promote-software-source command and required parameters to promote a versioned custom software source to a lifecycle stage. Promoting the software source to the first stage requires you use the software-source-id option.

    oci os-management-hub lifecycle-stage promote-software-source --stage-id ocid --software-source-id ocid [OPTIONS]

    For a complete list of flags and variable options for CLI commands, see the Command Line Reference.

  • Run the PromoteSoftwareSourceToLifecycleStage operation to promote a versioned custom software source to a lifecycle stage.