Перейти к основному содержимому

AWS CLI

Последнее изменение:

AWS CLI (AWS Command Line Interface) — это интерфейс командной строки для работы с сервисами AWS.

Настроить AWS CLI

  1. Настройте доступ к S3.
  2. Установите клиент.
  3. Создайте конфигурацию AWS CLI.
  4. Установите сертификат.

1. Настроить доступ к S3

Настроить доступ может Владелец аккаунта или пользователь с ролью iam.admin.

  1. Создайте сервисного пользователя с ролью с доступом в S3. Если вы создали сервисного пользователя с ролью object_storage_user или s3.bucket.user, в бакете должна быть настроена политика доступа и ее правила должны разрешать доступ этому пользователю.
  2. Выдайте пользователю S3-ключ.

2. Установить клиент

Используйте инструкцию Install or update to the latest version of the AWS CLI документации Amazon.

3. Создать конфигурацию AWS CLI

  1. Откройте терминал.

  2. Откройте режим конфигурирования:

    aws configure

  3. Введите AWS Access Key ID — значение поля Access key из S3-ключа.

  4. Введите AWS Secret Access Key — значение поля Secret key из S3-ключа.

  5. Введите Default region name — пул, в котором находится S3 (например, ru-1).

  6. Введите Default output format или оставьте пустым.

  7. Настройки будут сохранены в конфигурационных файлах:

    • учетные данные в .aws/credentials:

      [default]
      aws_access_key_id = <access_key>
      aws_secret_access_key = <secret_key>

    • пул по умолчанию в .aws/config:

      [default]
         region = <pool>

  8. В конфигурационном файле .aws/config добавьте параметр endpoint_url:

    [default]
        region = <pool>
        endpoint_url = https://<s3_domain>

    Укажите <s3_domain> — домен S3 API для нужного пула.

4. Установить сертификат

  1. Создайте папку ~/.selectels3/:

    mkdir -p ~/.selectels3/

  2. Скачайте сертификат и поместите его в папку ~/.selectels3/:

    wget https://secure.globalsign.net/cacert/root-r6.crt -O ~/.selectels3/root.crt
    openssl x509 -inform der -in ~/.selectels3/root.crt -out ~/.selectels3/root.crt
    chmod 600 ~/.selectels3/root.crt

  3. В конфигурационный файл .aws/config добавьте параметр:

    ca_bundle = ~/.selectels3/root.crt

Работа с AWS CLI

Синтаксис команд смотрите в инструкции AWS документации Amazon.

Для работы с S3 через AWS CLI используйте:

  • s3api — команды, соответствующие операциям в REST API;
  • s3 — дополнительные команды, упрощающие работу с большим количеством объектов.

Вывести список бакетов

  1. Откройте CLI.

  2. Выведите список бакетов:

    aws s3 ls

Создать бакет

  1. Откройте CLI.

  2. Создайте бакет:

    aws s3 mb s3://<bucket_name>

    Укажите <bucket_name> — имя нового бакета.

Посмотреть список объектов

  1. Откройте CLI.

  2. Посмотрите список объектов:

    aws s3 ls --recursive s3://<bucket_name>

    Укажите <bucket_name> — имя бакета, в котором нужно посмотреть список объектов.

Загрузить объект

  1. Откройте CLI.

  2. Загрузите объект в бакет:

    aws s3 cp <path_to_object> s3://<bucket_name>/

    Укажите:

    • <path_to_object> — путь в бакете, по которому будет храниться объект;
    • <bucket_name> — имя бакета, в котором будет храниться объект.

Вы можете получить ссылку на объект в публичном или приватном бакете через подписанный URL (Presigned URL). Подробнее о Presigned URLs в инструкции Sharing objects with presigned URLs документации AWS.

  1. Откройте CLI.

  2. Получите ссылку:

    aws s3 presign s3://<bucket_name>/<path_to_object> --expires-in <time>

    Укажите:

    • <bucket_name> — имя бакета, в котором хранится объект;
    • <path_to_object> — путь к объекту в бакете;
    • опционально: --expires-in <time> — срок действия ссылки, где <time> — время в секундах, через которое ссылка перестанет работать. Если не добавить параметр --expires-in <time>, ссылка будет работать один час.

Копировать объект

  1. Откройте CLI.

  2. Скопируйте объект:

    aws s3 cp s3://<bucket_name_1>/<path_to_object_1> s3://<bucket_name_2>/<path_to_object_2>

    Укажите:

    • <bucket_name_1> — имя бакета, в котором хранится объект для копирования;
    • <path_to_object_1> — путь к объекту для копирования в бакете;
    • <bucket_name_2> — имя бакета, в который будет скопирован объект;
    • <path_to_object_2> — путь в бакете, по которому будет храниться объект.

Удалить объект

  1. Откройте CLI.

  2. Удалите объект:

    aws s3 rm s3://<bucket_name>/<object_name>

    Укажите:

    • <bucket_name> — имя бакета;
    • <object_name> — имя объекта.