In this article:
- Understanding Box Basics
- Box management
- Contacting Cloud Application Manager Support
This article is meant to assist Cloud Application Manager customers who want to create and manage boxes.
Cloud Application Manager Users using Application Lifecycle Management (ALM) features.
- Access to Applications site (Application Lifecycle Management module) of Cloud Application Manager as an authorized user of an active Cloud Application Manager account.
Boxes are the templates that store application automation. An instance is a box you install on virtual infrastructure provisioned to a public, private cloud provider, or your own infrastructure. Take a quick tour to understand the layout of boxes and instances in Cloud Application Manager.
Boxes contain scripts, variables, and metadata to automate processes when instantiated on cloud infrastructure. Stitched together, boxes model complex processes like deploying or upgrading multi-tier enterprise scale applications.
So how do boxes work?. A typical application stack may consist of multiple boxes, each one modeling a step of the application’s install. For example, one might model the install of runtime requirements (such as PHP libraries). Another might model the install of a web server (such as Apache). And a third might model connecting to a source control repository (such as Git), pulling the latest code, and installing it on the virtual server. When stacked and instantiated these three boxes install an application. At the same time, each box is independent, reusable and can be consumed by other applications.
Understanding Box Basics
To create a new box, click New. Select a box type to match your automation:
- Application - Configure several boxes to deploy an application with a single click.
- Script - Automate using Bash, PowerShell, Salt, Ansible, Puppet, or Chef.
- Container - Automate using container technology like Docker.
- Template - Automate using AWS CloudFormation templates, ARM templates or Terraform templates.
- Deployment Policy - Select and share infrastructure resources, networking, and more from a cloud provider.
Fill mandatory fields (with an *) and define some basic metadata described below.
|Metadata||Box Type||What it Means|
|All||Give it a name and optionally a description and an icon.|
|It’s good practice to tag the runtime that the box requires to deploy. Cloud Application Manager auto suggests tags like Linux, Ubuntu, Java and so on. When ready to launch the box, you are presented with deployment policies that match the requirements. These deployment policies provide the right infrastructure or services the box needs to deploy.
Note: In CloudFormation boxes, the tags help you to look for binding instances.
|Select the level of updates to automatically apply to instances you launch of a box version:
+ Off - It’s turned off by default.
+ All Updates - Applies all changes.
+ Minor & Patch Updates - Applies minor and patch changes to the version deployed.
+ Patch Updates - Applies only the patch changes to the version deployed.
|Select the cloud provider registered in Cloud Application Manager for which you will carve out infrastructrure resources in the policy.|
|Tag the services and infrastructure that a policy provides like Linux, Ubuntu 12.04, load balancing, and so on for deployments. Add claims so that the boxes with matching requirements can successfully deploy using the right policy.|
|Determines how to [schedule instances](../Deploying Anywhere/deploying-managing-instances.md#scheduling-instances) for automatic expiration|
Once you create a box, you can configure and manage it in this panel:
Box Functions (marked with 1 in the figure) execute several commands for the Box
|Deploy||Launch a new instance of the box draft with this option. This lets you select a specific deployment policy to launch on a cloud provider.|
|Gear Menu||From here, you can edit basic metadata of the box, share or delete it.
Edit Details - Allows box basic properties edition.
Clone - Duplicates current box with same basic configuration.
Share - Invite team members to collaborate and improve the configuration or just let them deploy the box.
Delete Box - Removes current Box
Box Sections (marked with 2 in the figure) display several configurations of the Box
|Overview||Get detailed information about your box.|
|Code||Automate how a piece of software deploys in the virtual environment by parameterizing with variables and events.|
|Versions||Keep track deployment configuration changes with the help of versioning. Versions let you consume different configurations of the same box in multiple deployments. From this tab, you can create a new version, see a diff of what changed, or restore a version as the box draft.|
Contacting Cloud Application Manager Support
For issues related to API calls, send the request body along with details related to the issue.
In the case of a box error, share the box in the workspace that your organization and Cloud Application Manager can access and attach the logs.
- Linux: SSH and locate the log at /var/log/elasticbox/elasticbox-agent.log
- Windows: RDP into the instance to locate the log at \ProgramData\ElasticBox\Logs\elasticbox-agent.log