Deploying with Nitric Deploy
In this guide, we'll walk through the steps of getting started with Nitric Deploy. You'll deploy a new project in just a few minutes.
- Sign in to Nitric Deploy
- Create an organization
- Set up a connection to AWS
- Create or import a project
- Create an environment
- Configure environment variables
- Deploy your project
- View the logs
Nitric Deploy can be accessed by navigating to deploy.nitric.io - you'll be greeted by our sign-in screens. Follow the prompts to sign in with GitHub.
Organizations allow you to group your projects. For example, I have an organization that contains all of my demo projects.
Let's create a new organization and give it a name.
The next step is to set up a connection to your AWS account from your new organization. Navigate to
Connections and click Create connection. You can follow the instructions provided in the Create Connection dialog for steps to create the appropriate role in AWS and link it with your Nitric Deploy organization.
Projects can be imported from existing Git repositories or you can scaffold a new project from one of the templates. Start by clicking
New Project then choosing one of the two options below.
To import an existing project it must contain a
nitric.yaml file. This is automatically created and configured correctly using a template with the Nitric CLI or Nitric Deploy.
New project from a template
Our template projects will give you a starting point with, typically with a basic REST API.
Stacks represent deployed instances of your application using a specific cloud connection and region. You can have one or more stacks based on the development workflow you follow (e.g. dev, staging, prod), or if you need stacks in other regions or using different cloud connections.
If your project requires variables, they can be added in project settings.
Your project will automatically deploy when you create a stack and the right cloud infrastructure will be automatically provisioned. It will also deploy each time you push to the
linked branch selected when creating your environment.
Once you see the deployment tick over to success with a 'tick' you'll also notice that your preview/production URL is displayed. You can use this to access your deployed API.
If you scaffolded a template project then you can test the API out with the following command.
By clicking on 'view latest build' we can see the details and retrieve the deployment log information.
That's it! With just a few clicks, you've deployed a project to your cloud and don't have to manage environments or infrastructure state.
Try one of the following activities to keep going with Nitric: