Что это такое
Инструменты Amazon EC2 CLI используются для создания и управления своими ресурсами для Amazon EC2, Amazon EBS и Amazon VPC, например для импорта или экспорта виртуальных машин.
Каждый раз, когда вы используете Amazon EC2 CLI на вашей виртуальной машине, вы должны подтверждать свою личность. CLI Amazon EC2 использует ваши ключи доступа, чтобы идентифицировать вас, и подписывать запросы от вашего имени. Существует два типа ключей доступа: идентификаторы ключей доступа (access key IDs) и секретные ключи доступа (secret access keys). При создании пользователя вы должны были сохранить ваши ключи доступа в безопасном месте.
Примечание: если вы не можете найти свой секретный ключ доступа, создайте новые ключи доступа, иначе вы не сможете использовать инструменты CLI.
Установка на Amazon Linux
Выполните следующую команду в привилегированном режиме: sudo yum install -y aws-apitools-ec2
С помощью текстового редактора откройте файл ~/.bashrc для изменения конфигурации командной оболочки, например с помощью nano: sudo nano ~/.bashrc
Внесите следующие строки в открытый файл, указав ваши значения ключей: export AWS_ACCESS_KEY=your-aws-access-key-id
export AWS_SECRET_KEY=your-aws-secret-key
После сохранения файла необходимо обновить параметры оболочки для текущей сессии: source ~/.bashrc
Чтобы убедиться в корректности настроек, выполните следующую команду: ec2-describe-regions
Если вы получаете сообщение об ошибке, в котором отсутствует требуемый параметр, исправьте ошибки и повторите попытку.
Установка на Linux
Чтобу установить Amazon EC2 CLI скачайте архив с инструментами: wget http://s3.amazonaws.com/ec2-downloads/ec2-api-tools.zip
Создайте директорию для Amazon EC2 CLI с помощью команды mkdir: sudo mkdir /usr/local/ec2
Разархивируйте скачанный файл: sudo unzip ec2-api-tools.zip -d /usr/local/ec2
Примечания:
- .zip-файл содержит папку ec2-api-tools-x.x.x.x, где x.x.x.x - номер версии (например, ec2-api-tools-1.7.0.0);
- необходима установленная Java, процесс установки описан в нашей инструкции.
Установите переменные для поиска поддерживаемых библиотек (x.x.x.x - номер версии): export EC2_HOME=/usr/local/ec2/ec2-api-tools-х.х.х.х
export PATH=$PATH:$EC2_HOME/bin
Установите следующие переменные, указав ваши значения ключей: export AWS_ACCESS_KEY=your-aws-access-key-id
export AWS_SECRET_KEY=your-aws-secret-key
Чтобы убедиться в корректности настроек, выполните следующую команду: ec2-describe-regions
Если вы получаете сообщение об ошибке, в котором отсутствует требуемый параметр, исправьте ошибки и повторите попытку.
Установка на Windows
Инструменты Amazon EC2 CLI доступны в виде файла .zip на сайте Amazon EC2 CLI Tools. Инструменты написаны на Java и включают сценарии оболочки для Windows. Установка не требуется. Вы можете просто скачать файл и разархивировать его.
Для инструментов CLI Amazon EC2 требуется Java. Установка и настройка описана в нашей инструкции.
Далее необходимо установить переменную окружения EC2_HOME.
Нажмите кнопку Пуск, щелкните правой кнопкой мыши пункт Компьютер и выберите Свойства. Затем выберете Дополнительные настройки системы -> Переменные окружения. В разделе Пользовательские переменные нажмите Создать. В поле Имя переменной введите EC2_HOME. В поле Значение переменной введите путь к папке, в которой установлены инструменты командной строки. Например, C: \ AWS \ EC2 \ ec2-api-tools-1.7.0.0. Нажмите ОК.
Откройте командную строку и проверьте значение EC2_HOME с помощью команды: dir "%EC2_HOME%"
Если вы правильно установили переменную среды, вы увидите вывод списка папок. Если вы получили сообщение об ошибке «Файл не найден», проверьте настройки EC2_HOME, исправьте ошибки, откройте новое окно командной строки и повторите попытку.
Вернитесь к окну Переменные среды. В пользовательских переменных выберите Путь и затем нажмите Изменить. В значениях переменной добавьте ;% EC2_HOME%\bin и нажмите кнопку ОК.
Чтобы установить переменные окружения AWS_ACCESS_KEY и AWS_SECRET_KEY нажмите кнопку Пуск, щелкните правой кнопкой мыши пункт Компьютер и выберите Свойства. Далее выберите Дополнительные системные настройки -> Переменные среды. В разделе Пользовательские переменные нажмите Создать. В поле Имя переменной введите AWS_ACCESS_KEY. В поле Значение переменной укажите идентификатор ключа доступа. Нажмите ОК. В разделе Пользовательские переменные нажмите Создать. В поле Имя переменной введите AWS_SECRET_KEY. В поле Значение переменной укажите секретный ключ доступа. Нажмите ОК.
Чтобы убедиться, что все переменные среды настроены правильно, откройте новое окно командной строки и выполните следующую команду: ec2-describe-regions