Deploying to Any Infrastructure
In this article:
- Deploying to Any Infrastructure
- Bring your own infrastructure
- How to Deploy with the Cloud Application Manager Agent
- Cloud Application Manager Agent Command
- Contacting Cloud Application Manager Support
You can bring your own infrastructure to Cloud Application Manager by installing the Cloud Application Manager agent. This will enable lifecycle of the instance through Cloud Application Manager like with any other natively-deployed instance.
Cloud Application Manager users willing to register any infrastructure into it.
- An active Cloud Application Manager account.
- Any infrastructure capable of running Cloud Application Manager Agent.
Bring your own infrastructure
The preferred method to register any infrastructure in CAM, is to register it into a provider, instead of a stand-alone instance. To learn more about registering your servers into a compute instances provider, please review the Using Compute Instances article.
You can launch boxes on any infrastructure by running the Cloud Application Manager agent. The agent is required to execute box variables and scripts and run lifecycle operations. To install the agent, you run a Bash command. The infrastructure can be a virtual machine in your laptop, physical machines on premise, a datacenter, or any cloud provider environment. We support running it on Linux distributions Debian 6 and 7, Ubuntu 12.04 and 14.04, RedHat 6.x, CentOS 6.x, and any AWS Linux AMI. No matter where you choose to deploy, boxes launch consistently as they would on any cloud provider.
How to Deploy with the Cloud Application Manager Agent
Run the Cloud Application Manager agent on the Linux machine where you want to launch the box. Once the box is launched, sign in to Cloud Application Manager and access the instance from the Instances to edit its box makeup, debug, or manage its lifecycle. Follow these steps to launch a box on your infrastructure.
Before You Begin
- Make sure you have a box configured and ready to launch.
- Get the target infrastructure where you want to launch your box up and running first. This can be any Linux machine running a supported image.
SSH into the machine to run the agent. Here as an example, we SSH into a Linux machine running Ubuntu 12.04 in AWS.
ssh -i /Users/mrina/Documents/AWS_Private_PublicKeyPairs/AWSEC2_KeyPair/useast-mrina.pem firstname.lastname@example.org
Launch an instance of a box using the the Cloud Application Manager agent. In this example, we launch an instance of the public MongoDB box in AWS.
curl -sSL https://cam.ctl.io | sudo bash -s -- -b "MongoDB Server" -n "test" -V username=admin123 -V password=password12345 -t 314a36ad-74b6-4205-9e33-eac9970e4a1b
Cloud Application Manager Agent Command
Use cURL to download and run the agent with piped parameters.
curl -sSL https://cam.ctl.io | sudo bash -s -- -b "<box name or ID>" -n "<environment nameID>" -t <your_authentication_tokenID> -V <variable_name="variable value"ID> [-o "ID<owner IDID>"] [-d] [-H] [h] [f]
|-b||Specify a box by name or ID. If you give the name, the latest version of the box is launched. If you give the ID that specific version of the box is launched. You can get the ID from the box URL.|
|-n||Give a name to identify the environment where you launch the box, such as dev or test. If you don’t provide one, Cloud Application Manager uses the box name or ID.|
|-t||Enter your authentication token, which you can get from your account in the Cloud Application Manager website. If you run the agent command without this parameter, you’re prompted to enter it later.|
|-V||If a box needs values for certain variables before launching, you can pass each in this format: -V variable_name1=variable_value -V variable_name2=variable_value|
|-o||Optionally, specify in lowercase the box owner ID to tag an instance with this information. You can get the ID when you try to share the box with an owner. The owner can be an account or a workspace. The owner ID is visible within parentheses next to the display name.|
|-d||Optionally, see all the values in each step of the shell script as it executes the box you specified in the target environment.|
|-h||Get help and usage examples with this option.|
|-H||Specify the hostname vanity URL if using the appliance.|
|-f||Force the agent to install. If an Cloud Application Manager agent is previously running on the machine, the force flag kills and reinstalls the agent.|
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 ProgramDataElasticBoxLogselasticbox-agent.log