Continuous deployment
You can automatically deploy all changes that you make to a fork of the nRF Asset Tracker for AWS.
Note
It is optional to keep the deployment in your AWS account automatically synchronized with your fork’s source code repository.
Fork the nRF Asset Tracker repositories
To enable continuous deployment, complete the following steps:
Fork the nRF Asset Tracker for AWS repository.
Update the repository.url in the
package.json
file in your fork. It must point to the repository URL of your fork.Update the deploy.webApp.repository in the
package.json
file of your nRF Asset Tracker for AWS fork. It must point to the repository URL of your fork of the nRF Asset Tracker web application.
Provide GitHub credentials
Enabling continuous deployment creates an AWS CodePipeline project. You need to provide it with GitHub credentials to be able to register a webhook in the GitHub repository of your fork to be notified about changes. This is a manual one-time step.
You need to create a developer token with repo
and admin:repo_hook
permissions for an account that has write permissions to your repository.
Note
It is recommended to use a separate GitHub account instead of your personal GitHub account.
To provide this token to the nRF Asset Tracker for AWS, use the following command:
./cli.sh configure codebuild github token "Github Token"
Enable continuous deployment
After providing the GitHub credentials, set up the continuous deployment by enabling it before deploying the stack:
./cli.sh configure context stack cd 1
npx cdk deploy --all
This sets up an AWS CodePipeline, which triggers an AWS CodeBuild project for every push to the saga
branch.
You can customize the branch by providing the name in deploy.branch
in the package.json
file of your nRF Asset Tracker for AWS fork.
Another AWS CodePipeline is set up for the web application.
It triggers a CodeBuild project for every push to the saga
branch.
Configure the repository URL and the branch for the web application in the deploy.webApp
property of the package.json
file of your nRF Asset Tracker for AWS fork.
Trigger a deployment
Commit a change to your fork to trigger a deployment.
Check the status of the continuous deployment
To check the status of the continuous deployment after you have made the changes, use the following CLI command:
./cli.sh cd
The following image shows a sample output generated by the command: