# 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="/files/aqrRvoPAZk4LUNvcjhC6" 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 %}


---

# 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.instruqt.com/sandboxes/cloud-accounts/cloud-client.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.
