Apps

Apps allow instances having general relationships to be grouped in a clean and organized manner. App functionality enables full control of which instances belong in an app as well setting Firewall and Access Control List (ACL) rules. Use Apps to structure all necessary components into a single place. Add checks and groups for web servers, database nodes, etc.

Apps can be created from Blueprints, which are made in Provisioning -> Blueprints or from Existing Apps.

Creating Apps from Blueprints

1. Click +ADD on the right side of the main Apps section in Provisioning.

2. Select an existing App Blueprint and click NEXT.

   Note

   Blueprints must be created in in Provisioning -> Blueprints. to appear as options when creating an App.

3. Enter a Name for the App and select a Group. Default Cloud and Env can also be selected.

4. Click NEXT. Blueprint configurations matching the Group, Cloud and Environment selections will auto-populate the configurations of the Instances in the App. If no Blueprint Configuration matched the Group, Cloud or Env selections, the Instances will have default configurations.

5. Configure your Instances. Depending on the Blueprint Configurations settings, instances may already be fully configured. Fields that are locked in a Blueprint cannot be edited when creating an App.

   Note

   Once an Instance is fully configured, a green checkmark will appear next to the Instance. Instances that have required fields that need populated will have a red X and must be completed. If your Blueprint is already fully configured you can simply select complete!

6. Select COMPLETE and the App will be created and the Instances will begin provisioning.

Creating Apps from Existing Instances

1. Click +ADD on the right side of the main Apps section in Provisioning.

2. Select APP FROM EXISTING INSTANCES from the Blueprints list and click NEXT.

3. Enter a Name for the App and select a Group. Default Cloud and Env can also be selected.

   Note

   Only instances within the selected Group and Cloud will be available to be added to the App.

4. In the STRUCTURE section, select + to add a Tier

5. Select or enter a Tier Name.

6. Select the Tier to set Boot Order, rename, or once multiple Tiers are added, connect the Tier to other Tiers.

7. In the STRUCTURE section, select + in a Tier to add an Instance

8. Select the Instance Type of the Existing Instance to be added to the App.

9. In the STRUCTURE section, select the Instance.

10. In the CONFIGURATION section, select the Cloud the Existing Instance is in. Existing INSTANCES that match the Group, Cloud and Instance Types set will populate.

11. Select the desired Instance from the INSTANCES list. Selected instance will show in the SELECTED INSTANCE section.

    Note

    Only one existing Instance can be added per Instance. To add multiple Existing Instances, repeat the step above including adding an Instance for each Existing Instance to be added to the App.

12. Once all Existing Instances have been selected, click COMPLETE.

13. A new App will be created out of the Existing Instances.

Exporting Configuration JSON

To export a Blueprint as JSON:

1. Navigate to Provisioning > Apps

2. Select an App from the list to view the App detail page

3. Click the Actions button and select Export

4. The App export file will be downloaded to your computer as {app_name}.json

Provisioning Apps via API

A quick example of how this work: https://d.pr/i/yxsW7t