Install Dynatrace Configuration as Code via Monaco

This guide shows you how to download and install Dynatrace Configuration as Code via Monaco (the Dynatrace Monaco CLI).

Install the Dynatrace Monaco CLI

Linux

Download the latest version of the Dynatrace Configuration as Code CLI tool.

curl -L https://github.com/Dynatrace/dynatrace-configuration-as-code/releases/latest/download/monaco-linux-amd64 -o monaco-linux-amd64

optional Verify the downloaded binary using the checksum.
To verify that the downloaded binary is valid
1. Download its checksum file.
  
  curl -L https://github.com/Dynatrace/dynatrace-configuration-as-code/releases/latest/download/monaco-linux-amd64.sha256 -o monaco.sha256
1. Verify the downloaded binary using the checksum.
  
  shasum -c monaco.sha256
  
  You should see the following output.
  
  monaco-linux-amd64: OK
  
  This requires monaco-linux-amd64 and monaco.sha256 to be in the same directory, which they are if you followed the steps above.
Rename the specific executable to monaco.
```
mv monaco-linux-amd64 monaco
```
Make the binary executable.
```
chmod +x monaco
```
optional Install Dynatrace Configuration as Code CLI to a central location in your PATH.
```
sudo mv monaco /usr/local/bin/
```
This command assumes that you downloaded the binary to the current folder with the curl command described in step 1 and that your $PATH includes /usr/local/bin.

Download the latest version of the Dynatrace Configuration as Code CLI tool.

curl -L https://github.com/Dynatrace/dynatrace-configuration-as-code/releases/latest/download/monaco-linux-386 -o monaco-linux-386

optional Verify the downloaded binary using the checksum.
To verify that the downloaded binary is valid
1. Download its checksum file.
  
  curl -L https://github.com/Dynatrace/dynatrace-configuration-as-code/releases/latest/download/monaco-linux-386.sha256 -o monaco.sha256
1. Verify the downloaded binary using the checksum.
  
  shasum -c monaco.sha256
  
  You should see the following output.
  
  monaco-linux-386: OK
  
  This requires monaco-linux-386 and monaco.sha256 to be in the same directory, which they are if you followed the steps above.
Rename the specific executable to monaco.
```
mv monaco-linux-386 monaco
```
Make the binary executable.
```
chmod +x monaco
```
optional Install Dynatrace Configuration as Code CLI to a central location in your PATH.
```
sudo mv monaco /usr/local/bin/
```
This command assumes that you downloaded the binary to the current folder with the curl command described in step 1 and that your $PATH includes /usr/local/bin.

macOS

Download the latest version of the Dynatrace Configuration as Code CLI tool.

curl -L https://github.com/Dynatrace/dynatrace-configuration-as-code/releases/latest/download/monaco-darwin-arm64 -o monaco-darwin-arm64

optional Verify the downloaded binary using the checksum.
To verify that the downloaded binary is valid
1. Download its checksum file.
  
  curl -L https://github.com/Dynatrace/dynatrace-configuration-as-code/releases/latest/download/monaco-darwin-arm64.sha256 -o monaco.sha256
1. Verify the downloaded binary using the checksum.
  
  shasum -c monaco.sha256
  
  You should see the following output.
  
  monaco-darwin-arm64: OK
  
  This requires monaco-darwin-arm64 and monaco.sha256 to be in the same directory, which they are if you followed the steps above.
Rename the specific executable to monaco.
```
mv monaco-darwin-arm64 monaco
```
Make the binary executable.
```
chmod +x monaco
```
optional Install Dynatrace Configuration as Code CLI to a central location in your PATH.
```
sudo mv monaco /usr/local/bin/
```
This command assumes that you downloaded the binary to the current folder with the curl command described in step 1 and that your $PATH includes /usr/local/bin.

Download the latest version of the Dynatrace Configuration as Code CLI tool.

curl -L https://github.com/Dynatrace/dynatrace-configuration-as-code/releases/latest/download/monaco-darwin-amd64 -o monaco-darwin-amd64

optional Verify the downloaded binary using the checksum.
To verify that the downloaded binary is valid
1. Download its checksum file.
  
  curl -L https://github.com/Dynatrace/dynatrace-configuration-as-code/releases/latest/download/monaco-darwin-amd64.sha256 -o monaco.sha256
1. Verify the downloaded binary using the checksum.
  
  shasum -c monaco.sha256
  
  You should see the following output.
  
  monaco-darwin-amd64: OK
  
  This requires monaco-darwin-amd64 and monaco.sha256 to be in the same directory, which they are if you followed the steps above.
Rename the specific executable to monaco.
```
mv monaco-darwin-amd64 monaco
```
Make the binary executable.
```
chmod +x monaco
```
optional Install Dynatrace Configuration as Code CLI to a central location in your PATH.
```
sudo mv monaco /usr/local/bin/
```
This command assumes that you downloaded the binary to the current folder with the curl command described in step 1 and that your $PATH includes /usr/local/bin.

Windows

Open Windows PowerShell.

Download the latest version of the Dynatrace Configuration as Code CLI tool.

Invoke-WebRequest -URI https://github.com/Dynatrace/dynatrace-configuration-as-code/releases/latest/download/monaco-windows-amd64.exe -OutFile monaco.exe

This executable is signed by Dynatrace.

optional Add Monaco to a central location in your PATH.
1. Move monaco to the folder you want to add your PATH.
2. Go to Environment Variables in your system settings.
3. Scroll through system variables until you find PATH.
4. Edit and change accordingly.
  Use a semicolon delimiter between the previous entry and your new path (c:\path;<your-new-path>).
5. Launch a new console for the settings to take effect.

Open Windows PowerShell.

Download the latest version of the Dynatrace Configuration as Code CLI tool.

Invoke-WebRequest -URI https://github.com/Dynatrace/dynatrace-configuration-as-code/releases/latest/download/monaco-windows-386.exe -OutFile monaco.exe

This executable is signed by Dynatrace.

optional Add Monaco to a central location in your PATH.
1. Move monaco to the folder you want to add your PATH.
2. Go to Environment Variables in your system settings.
3. Scroll through system variables until you find PATH.
4. Edit and change accordingly.
  Use a semicolon delimiter between the previous entry and your new path (c:\path;<your-new-path>).
5. Launch a new console for the settings to take effect.

Container image

A container image of the Dynatrace Monaco CLI is available to simplify usage in CI/CD pipelines.

Images are available via Docker Hub:

docker pull dynatrace/dynatrace-configuration-as-code:latest

You can use the image directly with the CLI commands or as a CI container with a monaco executable available inside.

By default, commands run in the container image are running from a /monaco working directory. If you map your configurations into the container as a Docker volume, it's easiest to map the volume to this directory.

In the following example, we validate a project contained in /your/path/to/project with a manifest.yaml reading the deployment access token from an API_TOKEN variable.

docker run \
  --env API_TOKEN=XXX \
  --mount type=bind,src="/your/path/to/project",target=/monaco \
  dynatrace/dynatrace-configuration-as-code:latest deploy -d manifest.yaml

The container image uses the monaco executable as its entrypoint, so any inputs are passed directly to it.

However, some CI/CD tools (for example, GitLab CI/CD) need a regular shell as entrypoint. To make the container image work with these tools, you need to overwrite the entrypoint with sh.

GitLab CI/CD

For details on how to use the image with GitLab CI/CD, follow the Override the entrypoint of an image GitLab documentation.
docker run

For general information on overwriting container entrypoints when using docker run, see the Docker documentation.

Verify the image signature

Dynatrace Monaco CLI version 2.2.0+

The container image is signed to allow you to verify its authenticity.

You can verify the signature using cosign and the cosign.pub key that can be downloaded from the GitHub release page.

To verify the signature of a given version

Install the applicable version of cosign for your operating system, following the installation instructions.
Download the cosign.pub public key from the GitHub release page of the version you wish to verify.

Verify the container image of the version you wish to check:

cosign verify --key cosign.pub dynatrace/dynatrace-configuration-as-code:[VERSION]

For example, to verify version 2.2.0:

cosign verify --key cosign.pub dynatrace/dynatrace-configuration-as-code:2.2.0

Run monaco

Execute the monaco command to try out the downloaded CLI.

> monaco
Tool used to deploy dynatrace configurations via the cli

Examples:
  Deploy configuration defined in a manifest
    monaco deploy service.yaml
  Deploy a specific environment within an manifest
    monaco deploy service.yaml -e dev

Usage:
  monaco <command> [flags]
  monaco [command]

Available Commands:
  completion  Generate the autocompletion script for the specified shell
  convert     Convert v1 monaco configuration into v2 format
  delete      Delete configurations defined in delete.yaml from the environments defined in the manifest
  deploy      Deploy configurations to Dynatrace environments
  download    Download configuration from Dynatrace
  generate    Generate offers several sub-commands to generate files - take a look at the sub-commands for usage
  help        Help about any command
  version     Prints out the version of the monaco cli

Flags:
  -h, --help              help for monaco
      --support-archive   Create support archive
  -v, --verbose           Enable debug logging

Use "monaco [command] --help" for more information about a command.

What's next

Learn by doing in Deploy your first configuration.
Learn how available memory and CPU impact deployments in Hardware requirements for Dynatrace Monaco CLI.

Install Dynatrace Configuration as Code via Monaco

Install the Dynatrace Monaco CLI

Linux

macOS

Windows

Container image

Verify the image signature

Run monaco

What's next

Related topics