# 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"

<figure><img src="https://3502151236-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-naNCUtT6Gw1tfDjRR%2Fuploads%2FQadD13x7vHVBlZt1TshC%2Fimage.png?alt=media&#x26;token=00903ea9-b49c-4ed9-87bd-8fbc29bba10b" alt=""><figcaption></figcaption></figure>

* 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.

<figure><img src="https://3502151236-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-naNCUtT6Gw1tfDjRR%2Fuploads%2F2wqaAOWV4RrZadoRDcoq%2Fimage.png?alt=media&#x26;token=a5bc49cd-52a5-4163-ba9e-9cfe281e7657" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3502151236-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-naNCUtT6Gw1tfDjRR%2Fuploads%2F5G8IcYJueX2uaTKfgQvM%2Fimage.png?alt=media&#x26;token=83ed9422-b57d-4fa3-9b19-b8305315d07a" alt=""><figcaption><p>Please consider using the "Secrets Manager" rather than the "Plaintext" option</p></figcaption></figure>

{% hint style="info" %}
To retrieve a Meterian API Token visit the [Meterian Dashboard](https://www.meterian.com/account); in your account select the tab "Tokens" and create a new one, or use an existing one.
{% endhint %}

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:

<pre><code>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 
<strong>
</strong></code></pre>

Now save and run your first build.&#x20;

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](https://docs.meterian.io/the-client/client) or [Meterian Dockerized Client](https://docs.meterian.io/the-client/the-meterian-client-dockerized) read the documentation.

{% hint style="info" %}
It is possible to specify more [client parameters](https://docs.meterian.io/the-client/command-line-parameters).
{% endhint %}

<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.meterian.io/ci-server-integrations/aws-codebuild.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.