Skip to main content

Dev Portal

Overview​

The Dev Portal provides a streamlined interface for developers to deploy cloud resources using subscribed templates. Select a template from those available to you, configure the parameters your platform team has exposed, and run the Workflow, all in a controlled environment. This ensures consistency and security while platform teams maintain governance over infrastructure.

To get started, open the Orchestrator and select Dev Portal from the sidebar. Here's a quick overview of the Dev Portal in action:

How to create a Workflow/Stack​

To create a Workflow/Stack via the Dev Portal:

  1. Search for a template in the Search bar.
  2. On the template card, click Select.
How to select a Template

How to select a Template

The Workflow/Stack will be configured in three steps:

Step 1: Configure Workflow/Stack meta details​

  1. Fill in the following fields:
    • Template Revision: The Revision notes contains information about the selected Revision.
    • Workflow Group Name: Select an existing Workflow Group or create a new one (the most recently created is selected by default).
    • Resource ID: Auto-generated from the Workflow Group Name. You can customize it using only letters, numbers, underscores (_), or dashes (-). This cannot be changed after creation.
    • Workflow Name
    • Resource ID: Auto-generated from the Workflow/Stack Name. You can customize it using only letters, numbers, underscores (_), or dashes (-). This cannot be changed after creation.
    • Description: Add a short description (e.g., Creates EC2 key pairs on AWS).
    • Tags
  2. Click Next Step: Connectors.
How to configure Workflow meta details

How to configure Workflow meta details

Step 2: Configure Connector details​

  1. Select a pre-configured Connector.
  2. Select a Child Connector.
  3. Configure your runtime environment:
    • Add Environment Variables, or
    • Select Reference value to use outputs or Vault Secrets from another Workflow or Template.
  4. Click Next Step: Template Parameters.
Dev Portal interface with fields for selecting a Connector, Child Connector, and environment variables, with the Next Step: Template Parameters button at the bottom

Connectors details

info

When creating a Stack, you can enable Different Connector per Workflow to configure a specific Connector and environment variables for each Workflow in the Stack.

What happens when you select Different Connector per Workflow

Different Connector per Workflow

Step 3: Configure Template Parameters​

  1. Fill in the main parameters and step-specific parameters for your selected Template.
  2. Click Next Step: Create.
Dev Portal interface with fields of the Template parameter, with the Next Step: Create button at the bottom

Template Parameters details

info

When creating a Stack, you can enable Show All Templates to display all Workflows in the Stack, including those without template parameters to configure.

What happens when you select Show All Templates

Show All Templates

  1. The Workflow/Stack will be created. Click Go to Settings for additional configuration, or Run Workflow to run it straight away.
Dev Portal interface with the Workflow Run details

Workflow Run created

Once the Workflow is created, you can continue configuring it through Workflow Settings or run it straight away.

View Workflow as JSON​

During the creation process, you can view the JSON representation of your Workflow/Stack configuration. This is useful for creating or managing Workflows/Stacks with external systems and automation tools such as the StackGuardian API, ServiceNow, and others.

Click on View Workflow/Stack as JSON in the bottom-left corner of the screen, inside the Creation Summary.

Dev Portal interface with the Workflow Run details

Workflow as JSON

info

Settings you haven't configured yet may appear empty or set to default values. Review the JSON before using it.

Create from Git​

The Dev Portal allows you to deploy directly from a Git repository instead of using a pre-configured template. This option is ideal when you want to deploy your own infrastructure code.

To get started, open Orchestrator, select Dev Portal from the sidebar, and click Use Git.

Use Git

Use Git

After you click Select on your chosen infrastructure type, the Workflow will be created in three steps:

Step 1: Configure​

Name your deployment and choose where to save it.

  1. Fill in the following fields:
    • Workflow Group Name: Select an existing Workflow Group or create a new one (the most recently created is selected by default).
    • Workflow Name
    • Description (optional): Add a short description.
    • Tags (optional): Add labels to help find this deployment later.
    • Context Tags (optional): Add structured key-value pairs for automation or governance rules.
  2. Click Next Step: Git Repository.

Step 2: Git Repository​

Connect your repository and choose the code to deploy.

  1. Select a Version Control provider (GitHub, GitLab, etc.).
  2. Enter or search for the Repository URL.
  3. Optionally, expand Advanced Options to configure:
    • Branch, Tag or Commit: Specify the branch, tag, or commit to deploy (default: main).
    • Working Dir: The folder in your repository containing the code to deploy.
    • Git Sparse Checkout Config: Download only specific folders from your repository.
    • Enable git core.autocrlf: Enable automatic line ending conversion.
  4. Configure Template Parameters if your deployment requires input variables:
    • Select an Input Variables Methods option to define how values are passed to your deployment.
  5. Click Next Step: Connectors.

Step 3: Connectors​

Choose which cloud account to deploy to.

  1. Select a pre-configured Connector.
  2. Select a Child Connector.
  3. Configure your runtime environment:
    • Add Environment Variables, or
    • Select Reference Value to use outputs or Vault Secrets from another Workflow or Template.
  4. Click Create.