Skip to main content

Deploy Application or Infrastructure

danger

After you create your Application or Infrastructure, you will need to deploy it. The steps for this may vary depending on your Organization's pipeline configuration. For more information, contact the Account Admin or the person responsible for configuring the Self-hosted.

The deployment of Applications and Infrastructures in StackSpot is carried out through StackSpot Self-Hosted. This process uses Actions configured in a GitHub Workflow file to manage and orchestrate all deployment steps.

The process of initiating the deployment varies between organizations, as each defines the type of trigger used to start the StackSpot Self-Hosted workflow. These trigger configurations depend on the SCM (Source Code Management) provider and the workflow adopted by your Organization.

For example, the trigger to deploy can be manual, a 'push' action to a specific branch, or the action of publishing a release.

Examples of deployment configurations using GitHub

The following example assumes that you have configured the workflow file with the necessary information for StackSpot Self-Hosted in the “.github/workflows/stackspot-self-hosted.yaml” folder.

Your pipeline can include workflows that trigger the deployment workflow using triggers:

on.push.branches

You can define a specific branch that represents the environment where the deployment will occur. For example:

  • dev or development
  • prod or production
  • stg, staging or homologation

Example of a ‘./.github/workflows/deploy-dev.yaml’ file with a trigger to start the deployment of the development environment when there is a ‘push’ action on the dev branch.

name: Deploy in DEV

on:
  push:
    branches: [dev] # prod, stg, etc...

jobs: # Job that executes the StackSpot Self-Hosted workflow 
  deploy:
    uses: ./.github/workflows/stackspot-self-hosted.yaml
#.
#.
#. Dev environment configurations

on.release.types

You can decide to execute the deployment whenever a release of your project is published:

Example of a ‘./.github/workflows/deploy-release.yaml’ file with a trigger to start the deployment of the production environment when a release is published in your project.

name: Deploy in Production

on:
  release:
    types: [published]

jobs: # Job that executes the StackSpot Self-Hosted workflow 
  deploy:
    uses: ./.github/workflows/stackspot-self-hosted.yaml
#.
#.
#. Production environment configurations

You can directly configure the trigger in the StackSpot Self-Hosted workflow file. Check out the example on the StackSpot Self-Hosted page.

In this example, when you perform a ‘push’ action on a branch with the specified name or publish a release, the system executes the ‘stackspot-self-hosted.yaml’ workflow to deploy your Application or Infrastructure.