All pages
Powered by GitBook
1 of 5

Loading...

Loading...

Loading...

Loading...

Loading...

Automation Stacks

An outline of DuploCloud's Stacks feature for replicating, customizing, and managing resources

DuploCloud's Stacks feature is a no-code/low-code solution for importing, replicating, and managing resources across cloud environments. DuploCloud Stacks empowers users to replicate resources quickly and easily, minimizing onboarding time and reducing reliance on niche expertise.

Stacks supports a variety of use cases, from importing resources from external cloud providers like AWS, GCP, or Azure into the initial DuploCloud environment to replicating resources within the DuploCloud Platform. It facilitates iterative imports, allows granular scope selection for resources, and supports both form-based and JSON-based edits to customize configurations.

Clone from a Tenant

Clone resources from one Tenant to another using the DuploCloud Stacks feature

Cloning Resources from a Tenant

Clone resources (Nodes, Hosts, Services, Secrets, storage, etc.) from one Tenant to another using DuploCloud Stacks.

  1. Select the destination Tenant from the Tenant list box.

  2. Navigate to Automation -> Stacks.

  3. On the Deployments tab, click Clone. The Create Tenant Clone Job pane displays.

  4. Provide a Name for the clone Tenant, select the source Tenant from the Source Tenant list box, and specify the resources to be cloned in the Scope field.

  5. Click Next. The Deployment page for the clone job displays.

  1. On the Deployment page, configure the clone job details:

  • Select or unselect the resources you want to include in the clone job.

  • Click the edit icon () beside a resource to open and edit its settings. Click Save to save your changes.

  1. Click Submit. The selected resources from the source Tenant are cloned into the destination Tenant.

The Create Tenant Clone Job in the DuploCloud Portal
The Deployment page for a Tenant clone job in the DuploCloud Portal

Create a deploy template

Create a re-usable template to deploy resources using the DuploCloud Stacks feature.

Create a re-usable template to deploy resources (Nodes, Hosts, Services, Secrets, storage, etc.) using the DuploCloud Stacks feature.

  1. Select the Tenant from the Tenant list box that owns the resources that will act as a baseline for the new template.

  2. Navigate to Automation -> Stacks.

  3. Select the Templates tab.

  4. Click Generate. The Generate Deployment Template pane displays.

  5. Enter a name for the template in the Name field.

  6. Select all applicable scopes in the Scopes field. If unsure, you can safely add any scope, as it only affects the resource lists shown on the next page. The following scopes are currently available, with more to be added as new resource types are supported:

    • Kubernetes

    • Admin / Reverse Proxy

    • Admin / System Config

  7. Click Next. A page allowing you to edit the template configurations displays.

  8. Edit the template configurations as needed:

    • The left panel displays resources and their components (e.g., Kubernetes, Service, and filebeat-k8s-duploinfrasvc) organized hierarchically.

      • Subcomponents can be toggled on or off, controlling their inclusion in the template.

  9. Click the Download button to save the template file to your local machine for further use or modifications.

Admin / Tenant Security

  • Cloud / Host

  • Cloud / Load Balancer

  • Cloud / Storage

  • Docker

  • Selecting a parent node (e.g., Kubernetes) includes all its child components, while deselecting it removes them.
  • The right panel displays JSON that dynamically reflects the selections made on the left.

    • Adding or removing components on the left modifies the corresponding nodes and payloads in the JSON.

    • Advanced users can click Edit to fine-tune the JSON manually.

    • Click Save to save your changes.

  • Deploy from a template

    Deploy resources to Tenants using templates with DuploCloud Stacks

    Deploy resources (Nodes, Hosts, Services, Secrets, storage, etc.) to a Tenant using the DuploCloud Stacks feature.

    Uploading templates

    Upload templates in advance to make them available for deployment across all Tenants or for a specific Tenant to make them available only within that Tenant's environment. You can upload a template for a specific Tenant ahead of time, or at the time of deployment.

    Uploading a template for all Tenants

    1. From the DuploCloud Portal, navigate to Administrator -> System Settings.

    2. Select the Templates tab.

    3. Click Upload. The Upload Template pane displays.

    Uploading a template for a specific Tenant

    1. Select the Tenant that will use the template from the Tenant list box.

    2. Navigate to Automation -> Stacks.

    3. Select the Templates tab, and click Upload. The Upload Template pane displays.

    4. Enter a name for the template in the

    Uploading a template during deployment

    While creating a deployment following the , select the Upload File option, and upload the template you wish to use for the deployment.

    Viewing a template

    Access a read-only version of the template to view. To download an editable version of a template, see the .

    Viewing a template available to all Tenants

    1. From the DuploCloud Portal, navigate to Administrator -> System Settings.

    2. Select the Templates tab.

    3. In the row of the template you want to view, click the menu icon (), and select View.

    Viewing a template uploaded to a specific Tenant

    1. Select the Tenant that will use the template from the Tenant list box.

    2. Navigate to Automation -> Stacks.

    3. In the row of the template you want to view, click the menu icon (), and select View.

    Downloading a template

    Downloading a template available to all Tenants

    1. From the DuploCloud Portal, navigate to Administrator -> System Settings.

    2. Select the Templates tab.

    3. In the row of the template you want to Download, click the menu icon (), and select Download.

    Downloading a template uploaded to a specific Tenant

    1. Select the Tenant that will use the template from the Tenant list box.

    2. Navigate to Automation -> Stacks.

    3. In the row of the template you want to Download, click the menu icon (), and select Download.

    Deleting a template

    Deleting a template available to all Tenants

    1. From the DuploCloud Portal, navigate to Administrator -> System Settings.

    2. Select the Templates tab.

    3. In the row of the template you want to delete, click the menu icon (), and select Delete.

    Deleting a template uploaded to a specific Tenant

    1. Select the Tenant that will use the template from the Tenant list box.

    2. Navigate to Automation -> Stacks.

    3. In the row of the template you want to delete, click the menu icon (), and select Delete.

    Deploying a Stacks template

    1. Select the Tenant from the Tenant list box.

    2. Navigate to Automation -> Stacks.

    3. Select the Deployments tab.

    4. Click Deploy. The Deploy Template pane displays.

    Viewing Stacks deployments

    View a deployment's logs or configurations (in JSON).

    1. Select the Tenant from the Tenant list box.

    2. Navigate to Automation -> Stacks.

    3. Select the Deployments tab.

    4. Click on the deployment you want to view in the NAME column. Details for the selected deployment display.

    Enter a name for the template in the File Name field.
  • In the Module Type list box, Stack is selected by default. For steps related to the Agent Module Type, see below.

  • Click Choose File and select the file to upload.

  • Click Upload.

  • Name
    field.
  • Click Choose File, and select the file to upload.

  • Click Upload.

  • Enter a deployment name in the Name field.

  • Select how you will provide a template:

    • Upload File: Click Choose File and select the file to upload.

    • Select Template: From the Deploy Template list box, select the template to deploy.

  • Click Next.

  • If a dialog box displays, enter values for any necessary input variables, and click Next.

  • Click Deploy. Resources from the selected template are deployed into the selected Tenant.

  • On the left is a list of Resources organized hierarchically. Select the resource(s) you want to investigate.

  • On the right, details for the selected resource(s) display. Select JSON or Logs to inspect specific configurations or logs for that resource.

  • Click Close to return to the Deployments tab.

  • steps below
    instructions below
    The Upload Template pane

    Customize deploy templates

    Define custom input parameters and use built-in substitution keys to enhance Stacks deploy templates

    Customizing deploy templates

    Disclaimer

    These customization options are intended for advanced users familiar with JSON editing and deployment workflows. Improper modifications can break the template, potentially making it difficult to troubleshoot and restore. To avoid issues, always maintain a version history or backup of the original template before making changes. While some features, like adding custom input parameters, are straightforward and significantly enhance template utility, use caution when making complex edits.

    In-line editing of parameter fields

    For example, you can use a different instance size for a node.

    Creating custom input parameters

    Custom template input variables enhance template reusability by allowing dynamic values to be defined and inserted during use. To create a custom variable, wrap its name with double curly braces, like this: {{My Parameter Name}}. When the template is processed, you will be prompted to provide a value for each custom variable. This makes your templates more flexible and adaptable to different scenarios.

    Using substitution keys

    Substitution keys are predefined strings that are automatically replaced with corresponding values during template processing. Unlike custom template parameters, substitution keys do not require wrapping with special characters like double curly braces and are not listed in the pop-up dialog for custom input parameters. They can be inserted directly into the JSON template and will resolve dynamically. Below is a list of available built-in substitution keys and their descriptions.

    Substitution Key
    Value

    Removing a resource

    You can remove a resource from a deployment template to exclude it permanently. While this functions the same as unchecking a resource in the tree displayed just before deployment, the key difference is that the resource will no longer appear in the list at all.

    ref.duplo!dnssuffix

    External DNS Suffix for the Tenant's Plan.

    ref.duplo!tenantid

    Tenant ID

    ref.duplo!tenantname

    Tenant name

    ref.duplo!tenantinfraname

    Infrastructure name

    ref.duplo!tenantregion

    Tenant region (e.g., us-east-1).

    ref.duplo!k8sclustername

    K8s cluster name (the cluster deployed under the Tenant's Plan).

    ref.duplo!eksami

    AWS AMI ID for the latest EKS Node Image compatible with the Tenant's cluster version.