register

Описание

Регистрирует экземпляр EC2 или машину в AWS OpsWorks.

Регистрация машины с помощью этой команды установит агент AWS OpsWorks на целевой машине и зарегистрирует её в существующем стеке OpsWorks.

Синтаксис

  register
--stack-id <value>
--infrastructure-class <value>
[--override-hostname <value>]
[--override-private-ip <value>]
[--override-public-ip <value>]
[--override-ssh <value>]
[--ssh-username <value>]
[--ssh-private-key <value>]
[--local]
[--use-instance-profile]
[<target>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--stack-id (строка) Идентификатор стека. Экземпляр будет зарегистрирован в данном стеке.

--infrastructure-class (строка) Указывает, нужно ли регистрировать экземпляр EC2 (ec2) или локальный экземпляр (on-premises).

--override-hostname (строка) Имя хоста экземпляра. Если не указано, будет использовано текущее имя хоста машины.

--override-private-ip (строка) IP-адрес. Если задан этот параметр, указанный IP-адрес будет использоваться как частный IP-адрес в OpsWorks. В противном случае частный IP-адрес будет определён автоматически. Не использовать с экземплярами EC2.

--override-public-ip (строка) IP-адрес. Если задан этот параметр, указанный IP-адрес будет использоваться как публичный IP-адрес в OpsWorks. В противном случае публичный IP-адрес будет определён автоматически. Не использовать с экземплярами EC2.

--override-ssh (строка) Если задан этот параметр, указанная команда будет использована для подключения к машине.

--ssh-username (строка) Если указано, этот пользователь будет использован для подключения к хосту.

--ssh-private-key (строка) Если задано, данный файл закрытого ключа будет использован для подключения к машине.

--local (булево) Если указано, вместо удалённой машины будет импортирована локальная. Нельзя использовать вместе с target.

--use-instance-profile (булево) Использовать профиль экземпляра вместо создания пользователя IAM.

target (строка) Идентификатор экземпляра EC2 или имя хоста экземпляра или машины, которые необходимо зарегистрировать в OpsWorks. Нельзя использовать вместе с –local.

Глобальные параметры

--debug (булево)

Включить отладочную запись журнала.

--endpoint-url (строка)

Заменить URL по умолчанию команды указанным URL.

--no-verify-ssl (булево)

По умолчанию AWS CLI использует SSL при общении с сервисами AWS. Для каждого подключения SSL AWS CLI проверит сертификаты SSL. Этот параметр переопределяет стандартное поведение проверки сертификатов SSL.

--no-paginate (булево)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования вывода команды.

• json
• text
• table
• yaml
• yaml-stream

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использовать определённый профиль из файла данных.

--region (строка)

Использовать определённый регион. Переопределяет настройки конфигурации/среды.

--version (строка)

Отобразить версию этого инструмента.

--color (строка)

Включить/выключить цветной вывод.

• on
• off
• auto

--no-sign-request (булево)

Не подписывать запросы. Данные учетных данных не будут загружены, если этот аргумент указан.

--ca-bundle (строка)

Набор сертификатов CA для использования при проверке сертификатов SSL. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение равно 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию — 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения сокета в секундах. Если значение равно 0, подключение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию — 60 секунд.

--cli-binary-format (строка)

Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены в виде закодированной в base64 строки. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, которое соответствует двоичному блоку fileb:// всегда будет обрабатываться как двоичное и использовать содержимое файла напрямую независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.

• base64
• raw-in-base64-out

--no-cli-pager (булево)

Отключить вывод страницы CLI для вывода.

--cli-auto-prompt (булево)

Автоматически запросить параметры входных данных CLI.

--no-cli-auto-prompt (булево)

Отключить автоматическое запросы параметров входных данных CLI.

Примеры

Для регистрации экземпляров в стеке

Следующие примеры показывают различные способы регистрации экземпляров в стеке, созданном вне AWS OpsWorks. Вы можете запустить register с экземпляра, который необходимо зарегистрировать, или с отдельной рабочей станции. Дополнительную информацию см. в разделе Регистрация Amazon EC2 и локальных экземпляров в руководстве пользователя AWS OpsWorks.

Примечание: Для краткости в примерах опущен аргумент region.

Для регистрации экземпляра Amazon EC2

Чтобы указать, что вы регистрируете экземпляр EC2, установите аргумент --infrastructure-class в значение ec2.

В следующем примере регистрируется экземпляр EC2 в указанном стеке с отдельной рабочей станции. Экземпляр определяется по его идентификатору EC2, i-12345678. В примере используется стандартное имя пользователя SSH рабочей станции и попытка входа в экземпляр с использованием методов аутентификации, не требующих пароля, таких как стандартный закрытый SSH-ключ. Если это не удается, register запрашивает пароль.

aws opsworks register --infrastructure-class=ec2 --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb i-12345678

В следующем примере регистрируется экземпляр EC2 в указанном стеке с отдельной рабочей станции. Он использует аргументы --ssh-username и --ssh-private-key для явного указания имени пользователя SSH и файла закрытого ключа, которые команда использует для входа в экземпляр. ec2-user - стандартное имя пользователя для экземпляров Amazon Linux. Используйте ubuntu для экземпляров Ubuntu.

aws opsworks register --infrastructure-class=ec2 --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb --ssh-username ec2-user --ssh-private-key ssh_private_key i-12345678

В следующем примере регистрируется экземпляр EC2, на котором выполняется команда register. Войдите в экземпляр с помощью SSH и выполните register с аргументом --local вместо идентификатора экземпляра или имени хоста.

aws opsworks register --infrastructure-classec2 --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb --local

Для регистрации локального экземпляра

Чтобы указать, что вы регистрируете локальный экземпляр, установите аргумент --infrastructure-class в значение on-premises.

В следующем примере регистрируется существующий локальный экземпляр в указанном стеке с отдельной рабочей станции. Экземпляр определяется по его IP-адресу, 192.0.2.3. В примере используется стандартное имя пользователя SSH рабочей станции и попытка входа в экземпляр с использованием методов аутентификации, не требующих пароля, таких как стандартный закрытый SSH-ключ. Если это не удается, register запрашивает пароль.

aws opsworks register --infrastructure-classon-premises --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb 192.0.2.3

В следующем примере регистрируется локальный экземпляр в указанном стеке с отдельной рабочей станции. Экземпляр определяется по его имени хоста, host1. Аргументы --override-... направляют AWS OpsWorks на отображение webserver1 как имя хоста и 192.0.2.3 и 10.0.0.2 как публичный и частный IP-адреса экземпляра соответственно.

aws opsworks register --infrastructure-classon-premises --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb --override-hostname webserver1 --override-public-ip 192.0.2.3 --override-private-ip 10.0.0.2 host1

В следующем примере регистрируется локальный экземпляр в указанном стеке с отдельной рабочей станции. Экземпляр определяется по его IP-адресу. register входит в экземпляр с помощью указанного имени пользователя SSH и файла закрытого ключа.

aws opsworks register --infrastructure-classon-premises --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb --ssh-username admin --ssh-private-key ssh_private_key 192.0.2.3

В следующем примере регистрируется существующий локальный экземпляр в указанном стеке с отдельной рабочей станции. Команда входит в экземпляр с помощью настраиваемой строки команды SSH, которая указывает пароль SSH и IP-адрес экземпляра.

aws opsworks register --infrastructure-classon-premises --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb --override-ssh "sshpass -p 'mypassword' ssh your-user@192.0.2.3"

В следующем примере регистрируется локальный экземпляр, на котором выполняется команда register. Войдите в экземпляр с помощью SSH и выполните register с аргументом --local вместо идентификатора экземпляра или имени хоста.

aws opsworks register --infrastructure-classon-premises --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb --local

Вывод: Ниже приведен типичный вывод при регистрации экземпляра EC2.

Warning: Permanently added '52.11.41.206' (ECDSA) to the list of known hosts.
% Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                               Dload  Upload   Total   Spent    Left  Speed
100 6403k  100 6403k    0     0  2121k      0  0:00:03  0:00:03 --:--:-- 2121k
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Initializing AWS OpsWorks environment
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Running on Ubuntu
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Checking if OS is supported
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Running on supported OS
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Setup motd
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Executing: ln -sf --backup /etc/motd.opsworks-static /etc/motd
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Enabling multiverse repositories
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Customizing APT environment
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Installing system packages
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Executing: dpkg --configure -a
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Executing with retry: apt-get update
[Tue, 24 Feb 2015 20:49:13 +0000] opsworks-init: Executing: apt-get install -y ruby ruby-dev libicu-dev libssl-dev libxslt-dev libxml2-dev libyaml-dev monit
[Tue, 24 Feb 2015 20:50:13 +0000] opsworks-init: Using assets bucket fromenvironment: 'opsworks-instance-assets-us-east-1.s3.amazonaws.com'.
[Tue, 24 Feb 2015 20:50:13 +0000] opsworks-init: Installing Ruby for the agent
[Tue, 24 Feb 2015 20:50:13 +0000] opsworks-init: Executing: /tmp/opsworks-agent-installer.YgGq8wF3UUre6yDy/opsworks-agent-installer/opsworks-agent/bin/installer_wrapper.sh -r -R opsworks-instance-assets-us-east-1.s3.amazonaws.com
[Tue, 24 Feb 2015 20:50:44 +0000] opsworks-init: Starting the installer
Instance successfully registered. Instance ID: 4d6d1710-ded9-42a1-b08e-b043ad7af1e2
Connection to 52.11.41.206 closed.

Дополнительная информация

Дополнительную информацию см. в разделе Регистрация экземпляра со стеком AWS OpsWorks в руководстве пользователя AWS OpsWorks.