Создать виртуальную машину с метаданными из переменных окружения

Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

1. Задайте переменные окружения, содержащие имя локального пользователя ВМ и его SSH-ключ, которые будут подставлены в метаданные ВМ при последующем выполнении команды Yandex Cloud CLI:

   export USER_NAME="<имя_пользователя>"
   export SSH_KEY="<SSH-ключ>"
   

2. Создайте файл metadata.yaml и поместите в него следующую конфигурацию метаданных создаваемой ВМ:

   metadata.yaml

   #cloud-config
   datasource:
     Ec2:
       strict_id: false
   ssh_pwauth: no
   users:
   - name: $USER_NAME
     sudo: 'ALL=(ALL) NOPASSWD:ALL'
     shell: /bin/bash
     ssh_authorized_keys:
     - $SSH_KEY
   write_files:
     - path: "/usr/local/etc/startup.sh"
       permissions: "755"
       content: |
         #!/bin/bash
   
         apt-get update
         apt-get install -y nginx
         service nginx start
         sed -i -- "s/ nginx/ Yandex Cloud - $$HOSTNAME/" /var/www/html/index.nginx-debian.html
       defer: true
   runcmd:
     - ["/usr/local/etc/startup.sh"]
   

3. Выполните команду:

   yc compute instance create \
     --name <имя_ВМ> \
     --hostname <имя_хоста> \
     --zone <зона_доступности> \
     --network-interface subnet-name=<имя_подсети>,nat-ip-version=ipv4,security-group-ids=<идентификатор_группы_безопасности> \
     --create-boot-disk image-folder-id=standard-images,image-family=ubuntu-2204-lts \
     --metadata-from-file user-data="<путь_к_файлу_конфигурации>"
   

   Где:

   • --name — имя создаваемой ВМ.

   • --hostname — имя хоста создаваемой ВМ. Необязательный параметр. Если параметр не задан, в качестве имени хоста будет использовано значение идентификатора ВМ.

   • --zone — зона доступности, в которой будет находиться создаваемая ВМ.

   • --network-interface — настройки сетевого интерфейса создаваемой ВМ:

     • subnet-name — имя подсети, расположенной в зоне доступности, указанной в параметре --zone.
     • security-group-ids — идентификатор группы безопасности.

   • --metadata-from-file — ключ user-data, значением которого является путь к созданному ранее файлу с конфигурацией cloud-config в формате YAML. Например: --metadata-from-file user-data="/home/user/metadata.yaml".

     Примечание

     Обратите внимание, что при выполнении команды CLI для переменной HOSTNAME значение не будет подставлено в метаданные. Вместо этого при выполнении команды CLI в конфигурацию cloud-init будет передано имя переменной $HOSTNAME, а значение имени хоста создаваемой ВМ будет подставлено вместо этой переменной позднее при создании ВМ.

     Для этого в ключе user-data переменная HOSTNAME задана с двумя символами доллара: $$HOSTNAME. Подробнее см. в разделе Работа с переменными окружения в метаданных через CLI.

   Результат:

   done (36s)
   id: epd8m0fqvkuu********
   folder_id: b1gt6g8ht345********
   created_at: "2025-01-01T14:24:37Z"
   name: my-sample-vm
   zone_id: ru-central1-b
   platform_id: standard-v2
   resources:
     memory: "2147483648"
     cores: "2"
     core_fraction: "100"
   status: RUNNING
   metadata_options:
     gce_http_endpoint: ENABLED
     aws_v1_http_endpoint: ENABLED
     gce_http_token: ENABLED
     aws_v1_http_token: DISABLED
   boot_disk:
     mode: READ_WRITE
     device_name: epd60hoo48qj********
     auto_delete: true
     disk_id: epd60hoo48qj********
   network_interfaces:
     - index: "0"
       mac_address: d0:0d:8b:01:fa:fd
       subnet_id: e2lqsms4cdl3********
       primary_v4_address:
         address: 192.168.15.14
         one_to_one_nat:
           address: 51.250.**.**
           ip_version: IPV4
       security_group_ids:
         - enpbtvidu0g0********
   serial_port_settings:
     ssh_authorization: OS_LOGIN
   gpu_settings: {}
   fqdn: my-web-server.ru-central1.internal
   scheduling_policy: {}
   network_settings:
     type: STANDARD
   placement_policy: {}
   hardware_generation:
     legacy_features:
       pci_topology: PCI_TOPOLOGY_V1
   

   Другие примеры конфигурации для user-data см. в разделе Примеры.

   Подробнее о команде yc compute instance create см. в справочнике CLI.