Skip to main content

AWS CLI Configuration to target Astran

A specific configuration is required for the AWS CLI to request Astran services instead of AWS.

To avoid any interference with other uses of the CLI you might have, the following instructions will help you define this configuration as a new configuration profile.

Partition​

When your Astran Continuity Cloud account was created, a partition was assigned to you. This partition is usually named after your company. If you're not sure what your partition is, please contact our support team.

info

For the sake of this tutorial, we will use the partition demo.

Urls​

All Astran Continuity Cloud urls have the same structure.

https://PARTITION.SERVICE.astran.io
info

In this tutorial, if we were to refer to the url for the S3 service we would use https://demo.s3.astran.io

Configuration Steps​

  1. Open Your AWS CLI Configuration File, typically located at ~/.aws/config, with your favorite text editor.

  2. Add a new profile configuration (here named astran) :

    [profile astran]
    region = eu
    retry_mode = standard
    max_attempts = 1
    services=astran-services

    [services astran-services]
    s3 =
        endpoint_url = https://demo.s3.astran.io
        addressing_style = path
    sts =
        endpoint_url = https://demo.sts.astran.io
    iam =
        endpoint_url = https://demo.iam.astran.io
    caution

    Replace the partition in the URLs with the one provided by the Astran team.

  3. Enable the profile. Whenever you want to use the CLI with Astran Continuity Cloud, just define and export the variable AWS_PROFILE once in your terminal:

export AWS_PROFILE=astran

(Using the profile name defined at step 2).

Alternatively, you can pass the option --profile "astran" (again, using the right profile name) to every execution of the AWS CLI.