AWS CLI — консольный клиент для работы с хранилищами по протоколу S3. Он позволяет создавать бакеты, загружать и скачивать объекты, настраивать версионирование и правила жизненного цикла из командной строки и из скриптов. Клиент совместим с объектным хранилищем RTCloud.
Ниже — установка актуальной версии AWS CLI v2 на Linux, macOS и Windows. Полная и более подробная инструкция по установке, обновлению и проверке подписи доступна на сайте: https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html
Требования
- 64-разрядная операционная система.
- Утилита распаковки ZIP-архивов. Если встроенной команды unzip в системе нет, используйте любой аналог.
- На Linux клиент использует glibc, groff и less — в большинстве распространённых дистрибутивов они установлены по умолчанию.
- Поддерживаются 64-разрядные сборки актуальных версий CentOS, Fedora, Ubuntu, Amazon Linux 1, Amazon Linux 2, Amazon Linux 2023, а также Linux на архитектуре ARM.
- Для macOS — версия 11 или новее.
- Для Windows — права администратора.
Важно! AWS CLI первой и второй версии используют одно и то же имя команды — aws. Если на машине установлена первая версия, перед установкой второй её нужно удалить, иначе возможен конфликт. На Amazon Linux предустановленный пакет удаляется командой sudo yum remove awscli.
Linux на архитектуре x86 (64 бита)
Скачайте установщик, распакуйте архив и запустите установку:
curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install
По умолчанию файлы копируются в каталог /usr/local/aws-cli, а в /usr/local/bin создаётся символическая ссылка на исполняемый файл. Команда sudo требуется именно для записи в эти каталоги.
Установить клиент без прав суперпользователя можно, указав каталоги, доступные вам на запись:
./aws/install -i /usr/local/aws-cli -b /usr/local/bin
Параметр -i (--install-dir) задаёт каталог, куда копируются файлы клиента. Параметр -b (--bin-dir) задаёт каталог, в котором создаётся ссылка на команду aws; если указать каталог, уже входящий в переменную PATH, добавлять путь вручную не понадобится. В обоих путях не должно быть пробелов — иначе установка завершится ошибкой.
Linux на архитектуре ARM
Порядок тот же, отличается только имя архива:
curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install
Linux: установка через snap
Пакет в snap обновляется автоматически, поэтому подходит, если нужна всегда актуальная версия клиента. Выбор конкретной минорной версии в snap-пакете не поддерживается — если версию требуется зафиксировать, устанавливайте клиент из архива.
Если snap в системе не установлен, установите его, после чего выполните:
sudo snap install aws-cli --classic
macOS
Через графический установщик
- Скачайте пакет https://awscli.amazonaws.com/AWSCLIV2.pkg.
- Запустите его и следуйте указаниям мастера.
При установке для всех пользователей потребуются права администратора; файлы по умолчанию размещаются в /usr/local/aws-cli, а ссылка на исполняемый файл создаётся автоматически в /usr/local/bin/aws.
При установке только для текущего пользователя права администратора не нужны, но ссылки придётся создать вручную:
sudo ln -s /folder/installed/aws-cli/aws /usr/local/bin/aws
sudo ln -s /folder/installed/aws-cli/aws_completer /usr/local/bin/aws_completer
Через командную строку
curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg"
sudo installer -pkg ./AWSCLIV2.pkg -target /
Журнал установки записывается в файл /var/log/install.log.
Windows
Скачайте и запустите MSI-установщик https://awscli.amazonaws.com/AWSCLIV2.msi. Установку можно выполнить и из командной строки:
msiexec.exe /i https://awscli.amazonaws.com/AWSCLIV2.msi
Для установки без диалоговых окон добавьте ключ /qn:
msiexec.exe /i https://awscli.amazonaws.com/AWSCLIV2.msi /qn
Проверка установки
Откройте новое окно терминала и выполните:
aws --version
Ответ содержит версию клиента, версию Python и сведения об операционной системе:
aws-cli/2.27.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64
Если система сообщает, что команда не найдена, закройте и откройте терминал заново — переменные окружения обновляются только в новых сессиях. На Linux и macOS проверить, куда указывает ссылка, можно командой which aws.
Обновление клиента
Обновление выполняется тем же способом, каким выполнялась установка. При установке из архива в команду добавляется параметр --update с указанием текущих каталогов:
curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
unzip -u awscliv2.zip
sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update
Флаг -u у команды unzip перезаписывает существующие файлы без запроса подтверждения — это важно при автоматизации. Найти текущие каталоги, если вы их не помните, можно так:
which aws
ls -l /usr/local/bin/aws
Первая команда покажет путь для параметра --bin-dir, вторая — каталог, на который указывает ссылка, для параметра --install-dir.
На Windows достаточно скачать и запустить новый MSI-установщик: он перезапишет предыдущую версию.
Смотрите также:
к Работе с S3 RTCloud
