AWS CodeBuild

The integration of Meterian with AWS CodeBuild is very simple and it requires just a couple of steps.

New project

From the CodeBuild Developer tools dashboard create a new project.

Configure the build according according to your needs.

In the Environment section:

• Make sure your builds would get elevated privileges by selecting the checkbox right under "Privileged"

• Click "Additional configuration" at the bottom of the Environment section to be able to set environment variables, then set here the METERIAN_API_TOKEN variable.

Please consider using the "Secrets Manager" rather than the "Plaintext" option

To retrieve a Meterian API Token visit the Meterian Dashboard; in your account select the tab "Tokens" and create a new one, or use an existing one.

In the Buildspec section you will need specify the buildspec file of your project or directly edit it in the web interface using "Insert build command" > "Switch to editor". Here's a full example using the Dockerized Client:

version: 0.2

phases:
  build:
    commands:
      - docker pull -q meterian/cli
      - docker run --rm --volume $(pwd):/workspace 
        --env METERIAN_API_TOKEN=$METERIAN_API_TOKEN meterian/cli 

Now save and run your first build.

If the base image you are using contains the build tools then you can also configure the buildspec to use the Thin Client, which will allow for faster builds. Here's a full example:

version: 0.2

phases:
  build:
    commands:
    - curl -s "https://www.meterian.io/downloads/meterian-cli.jar" -o meterian-cli.jar
    - java -jar meterian-cli.jar --report-console  

For an advanced use of the Meterian Thin Client or Meterian Dockerized Client read the documentation.

It is possible to specify more client parameters.