Installs
Installs are instances of an application in a customer cloud account.
Installs are instances of an application in a customer cloud account.
What is an Install?
An install is an instance of an application running in a customer cloud account. When an install is created, each component in your application will be deployed in the correct order, alongside a runner which is responsible for managing the software.
Install Lifecycle
When an install is created, the following components are provisioned:
- sandbox - the base infrastructure for networking and compute.
- runner - the Nuon managed runner that manages the install.
- components - the parts of your application.
When an install is deleted, each component will be deleted in reverse order, according to its dependencies, and then the runner and sandbox are destroyed.
Install Management
The cli exposes many operational commands to manage an install.
To see all available commands, run: nuon installs --help
.
Pinning an Install
You can pin an install, which will set it’s ID as a default argument to all install commands. This is helpful to avoid
having to pass -i
to each command.
Each example below assumes you have run nuon installs select
first.
To show the currently pinned install:
Install Management Commands
Commands for creating, deleting and viewing installs.
Create an install - create an install for an AWS application, passing in one or more inputs.
Creating Azure installs is currently only supported using an installer, or our API.
Delete an install - delete an install
List all installs - list an install
Get an install - get an install
Install Sandbox Commands
Commands for working with an install’s sandbox.
Show sandbox updates - show all updates to an install sandbox.
Show sandbox run logs - show logs for a specific sandbox run.
Reprovision a sandbox - reprovision the sandbox with the latest configured sandbox version for an app.
Deprovision a sandbox - deprovision a sandbox.
Install Components
Each component is deployed to an install when it is first created. When a component is created after an install has been provisioned, it will automatically be deployed to it upon the first release.
The Nuon CLI provides the following commands to manage install components:
Each example here assumes you have run nuon installs select
first.
Show Deploys - show deploys for an install.
Deploy Logs - print logs for a deploy.
Deploy Plan - print a deploy plan for an install.
Deploying to a specific install
While iterating on your application’s configuration it can be helpful to deploy to a single install, you can do this by creating a release and targeting a single install id.