Updating an Orchestration v1

You can update an orchestration in either of the following ways:

  • Directly in the web console, by selecting the Update option.

    This option is enabled only when the orchestration is in the Stopped state.

  • By downloading the orchestration file to your local host and updating it using a text editor.

    You’ll have to stop and delete the existing orchestration before you can upload the modified orchestration and start it.

Caution:

You must stop an orchestration to update it. When you stop an orchestration, all the resources that were provisioned by that orchestration are deleted.

To complete this task, you must have the Compute_Operations role. If this role isn’t assigned to you or you’re not sure, then ask your system administrator to ensure that the role is assigned to you in Oracle Cloud Infrastructure Classic Console. See Modifying User Roles in Managing and Monitoring Oracle Cloud.

  1. Sign in to the Compute Classic console. If your domain spans multiple sites, select the appropriate site. To change the site, click the Site menu near the top of the page.
  2. Click the Orchestrations tab.
  3. You can update an orchestration either directly in the web console, or by downloading it to your local host.
    • To update an orchestration directly in the web console:
      1. Identify the orchestration that you want to update. If the orchestration is in the Ready state, to stop the orchestration, from the menu icon menu, select Stop.

        Caution:

        When you stop an orchestration, all the resources that were provisioned by that orchestration are deleted.

      2. When the orchestration is in the Stopped state, from the menu icon menu, select Update.

      3. Modify the orchestration as required. Ensure that your modifications contain valid JSON and that you don’t update any return parameters or read-only information. When you’re done, click Update.

    • To download an orchestration and edit it on your local host:
      1. Identify the orchestration that you want to update. From the menu icon menu, select Download, and save the orchestration file on your local host.

      2. Modify the downloaded orchestration file on your local host, as required, by using any text editor. You should also validate your JSON file. You can do this by using a third-party tool, such as JSONLint, or any other validation tool of your choice. If your JSON isn’t valid, then an error occurs when you upload the orchestration. Oracle doesn’t support or endorse any third-party JSON-validation tool.

      3. Stop the existing orchestration. Go to the orchestration that you want to update and, from the menu icon menu, select Stop.

        Caution:

        When you stop an orchestration, all the resources that were provisioned by that orchestration are deleted.

      4. Delete the existing orchestration. Go to the orchestration that you want to update and, from the menu icon menu, select Delete.

      5. Upload the edited orchestration file. Click Upload Orchestration and select the updated orchestration file, then click Upload.

  4. To start the updated orchestration, from the menu icon menu, select Start.

To download an orchestration using the CLI, use the opc compute orchestration get command. After editing an orchestration, to upload it using the CLI, use the opc compute orchestration update command. For help with these commands, run each command with the -h option. For the instructions to install the CLI client, see Preparing to Use the Compute Classic CLI in CLI Reference for Oracle Cloud Infrastructure Compute Classic.

To download an orchestration using the API, use the GET /orchestration/name method. After editing an orchestration, to upload it using the API, use the PUT /orchestration/name method. For more information, see REST API for Oracle Cloud Infrastructure Compute Classic.