# Cloud Client

## What is a Cloud Client?

The cloud client is a lightweight container that is preconfigured with the CLI tools for AWS, Azure, and GCP. It also provides a web service to display the cloud account credentials for the cloud account. An example of the web service can be seen below on the left.

<figure><img src="https://2094212015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGJDYBXyftBAZb1Wq0e%2Fuploads%2FK6W8hq9Iteq5XkgxxOjd%2FAWS%20cloud%20web%20service%20(1).png?alt=media&#x26;token=3c36730c-068a-45b8-b08d-2832ff5484b9" alt=""><figcaption></figcaption></figure>

### Step 1: Add an Instruqt Cloud Client container to your track

{% tabs %}
{% tab title="🌐 Web UI" %}

1. Click the track where you want to add an AWS account to.\
   ↳ Instruqt shows the corresponding *Track dashboard* page.
2. In the **Sandbox** section, click **Edit** to open the *Sandbox* page.
3. Click **+ Add a host**.
4. Pick the **Container** host type.
5. Input these values:

   <table><thead><tr><th width="154.77714213683458">Field</th><th>Value</th></tr></thead><tbody><tr><td><strong>Hostname</strong></td><td><code>cloud-client</code></td></tr><tr><td><strong>Image type</strong></td><td><code>Choose your own</code></td></tr><tr><td><strong>Container image*</strong></td><td><code>gcr.io/instruqt/cloud-client</code><br><strong>or</strong><br> <code>gcr.io/instruqt/cloud-client:2</code></td></tr></tbody></table>
6. Click **Show optional settings**. Enter these values:

   <table><thead><tr><th width="154.77714213683458">Field</th><th>Value</th></tr></thead><tbody><tr><td><strong>Ports</strong></td><td><code>80</code></td></tr><tr><td><strong>Shell</strong></td><td><code>/bin/bash</code></td></tr></tbody></table>
7. Click **Save host** to add the container.

\*Note: `gcr.io/instruqt/cloud-client:2`is an updated version of this container with newer versions of the AWS CLI tools pre-installed. This is offered as a separate container version to maintain compatibility with pre-existing customer scripts or processes. `cloud-client` offers aws-cli version 1.36.32, while `cloud-client:2` offers aws-cli version 2.22.27.
{% endtab %}

{% tab title="💻 Instruqt CLI" %}

1. Open the file `config.yml` in your code editor.
2. Copy and paste the following code under the `containers` property:

```yaml
- name: cloud-client
  image: gcr.io/instruqt/cloud-client
  ports: [80]
  shell: /bin/bash
  memory: 256
```

{% endtab %}
{% endtabs %}
