Adding a Shell Stage

Shell stage allows you to run custom commands in the deployment pipeline. This stage can be added at any point in the deployment pipeline.

You must prepare a command specification YAML file containing all the steps that you want to run during the deployment. The command spec is run on a container instance host in the selected compartment and subnet in your tenancy. You have the option to choose different instance configuration before the deployment. See Shell Container Image Runtime Details. When you run the deployment pipeline, you can see the execution of the steps defined in the command spec in the pipeline output and logs. For syntax and example of the command spec, see Command Specification.

Key Benefits of Adding a Shell Stage

  • Automate deployments to OCI platforms such as service mesh and container instances using OCI CLI and other pre-installed tools. See Shell Container Image Runtime Details.

    OCI CLI is pre-authenticated to use the pipeline resource principal to access OCI resources.

  • Run a database schema migration using command line tools such as Oracle SQL Developer Command Line (SQLcl).
  • Use any pipeline parameters by referencing them in the spec. Also replace parameters and variables during the deployment run.
  • Perform integration tests on artifacts before deploying to production.
  • Customize the DevOps workflow. For example, you can wait for some resources to be ready before the pipeline deploys additional resources.

Before you create the pipeline, you must have a DevOps project and a command specification artifact. Artifacts can be defined inline or located in the Artifact Registry.

Was this article helpful?