Publish your angular projects to a docker registry by just run `ng deploy your-app`
npm install ngx-deploy-dockerAngular CLI (v13.0.0 or greater) globally
nodeJs installed.
sh
npm install -g @angular/cli
ng new your-angular-project --defaults
cd your-angular-project
`
2. Add ngx-deploy-docker to your project.
`sh
ng add ngx-deploy-docker
`
3. Make sure, Docker works properly on your client and you are authenticated at the repository of your choice.
`sh
docker login
`
4. Deploy your newly built image to the registry with all default settings.
Your project will be automatically built in production mode.
`sh
ng deploy
`
Which is the same as:
`sh
ng deploy your-angular-project
`
🚀 Continuous Delivery
...more to come
📦 Options
#### --base-href
- optional
- Default: undefined (string)
- Example:
- ng deploy – The tag remains unchanged in your index.html
- ng deploy --base-href=/XXX/ – The tag is added to your index.html
Specifies the base URL for the application being built.
Same as ng build --base-href=/XXX/
#### --build-target
- optional
- Example:
- ng deploy – Angular project is build in production mode
- ng deploy --build-target= – Angular project is using the configuration test (this configuration must exist in the angular.json file)
A named build target, as specified in the configurations section of angular.json.
Each named target is accompanied by a configuration of option defaults for that target.
Same as ng run .
This command has no effect if the option --no-build option is active.
#### --no-build
- optional
- Default: false (boolean)
- Example:
- ng deploy – Angular project is build in production mode before the deployment
- ng deploy --no-build – Angular project is NOT build
Skip build process during deployment.
This can be used when you are sure that you haven't changed anything and want to deploy with the latest artifact.
This command causes the --build-target setting to have no effect.
#### --image-name
- optional
- Example:
- ng deploy – Docker Image is build with the name of the project as image name
- ng deploy --image-name=your-special-name – Docker Image is built with the name provided.
#### --account
- optional
- Alias: -a
- Default: (string)
- Example:
- ng deploy – Docker Image name is not prefixed.
- ng deploy --account=test – Docker image name is prefixed with the provided account, like account/image-name.
> This option may be necessary, depending on your write-rights within the repository, you want to push to.
#### --tag
- optional
- Alias: -t
- Default: latest (string)
- Example:
- ng deploy – Docker Image is build with the tag latest, e.g.account/image-name:latest
- ng deploy --tag=v1.0.0 – Docker Image is build with the tag v1.0.0
📁 Configuration File
To avoid all these command-line cmd options, you can write down your configuration in the angular.json file in the options attribute of your deploy project's architect. Just change the kebab-case to lower camel case. This is the notation of all options in lower camel case:
- baseHref
- buildTarget
- noBuild
- imageName
- account
- tag
A list of all available options is also available here.
Example:
`sh
ng deploy --build-target=:build:production --tag=next
`
becomes
`json
"deploy": {
"builder": "ngx-deploy-docker:deploy",
"options": {
"buildTarget": ":build:production",
"tag": "next"
}
}
`
And just run ng deploy 😄.
🏁 Next milestones
- Setup of CI/CD Pipeline for the project
- Code Restructuring:
- Modularization of Schematics and Builders
- Use what you need
- Testing, Testing, Testing:
- Manual tests on different clients with different OS
- Unit and Integration Tests
- Add more options to the deploy builder, what do you need?
- Integration in NxWorkspace
- 💅 Kubernetes deployment right from the CLI
- preparing examples of how to use the package in CI environment with different Providers for private registries`