Создать облачную сеть

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

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

Чтобы создать облачную сеть:

1. Посмотрите описание команды CLI для создания облачной сети:

   yc vpc network create --help
   

2. Создайте облачную сеть в каталоге по умолчанию:

   yc vpc network create \
     --name test-network-1 \
     --description "My test network"
   

   Параметры --name и --description необязательные — можно создать сеть без имени и описания и обращаться к ней по идентификатору.

   Требования к названию сети:

   • длина — от 2 до 63 символов;
   • может содержать строчные буквы латинского алфавита, цифры и дефисы;
   • первый символ — буква, последний — не дефис.

3. Получите список всех облачных сетей в каталоге по умолчанию:

   yc vpc network list
   

   Результат:

   +----------------------+----------------+
   |          ID          |      NAME      |
   +----------------------+----------------+
   | enpiuvhhd4t8******** | test-network-1 |
   | enplom7a98s1******** | default        |
   +----------------------+----------------+
   

   Получите тот же список с большим количеством деталей в формате YAML:

   yc vpc network list --format yaml
   

   Результат:

   - id: enpiuvhhd4t8********
     folder_id: b1g6ci08ma55********
     created_at: "2018-10-23T11:12:51Z"
     name: test-network-1
     description: My first network
   - id: enplom7a98s1********
     folder_id: b1g6ci08ma55********
     created_at: "2018-09-24T08:23:00Z"
     name: default
     description: Auto-created default network
   

Terraform позволяет быстро создать облачную инфраструктуру в Yandex Cloud и управлять ею с помощью файлов конфигураций. В файлах конфигураций хранится описание инфраструктуры на языке HCL (HashiCorp Configuration Language). При изменении файлов конфигураций Terraform автоматически определяет, какая часть вашей конфигурации уже развернута, что следует добавить или удалить.

Terraform распространяется под лицензией Business Source License, а провайдер Yandex Cloud для Terraform — под лицензией MPL-2.0.

Подробную информацию о ресурсах провайдера смотрите в документации на сайте Terraform или в зеркале.

Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.

1. Опишите в конфигурационном файле параметры облачной сети:

   • name — имя облачной сети. Требования к имени:

     • длина — от 2 до 63 символов;
     • может содержать строчные буквы латинского алфавита, цифры и дефисы;
     • первый символ — буква, последний — не дефис.

   • description — описание облачной сети.

   • labels — метки для облачной сети. Укажите пару ключ-значение.

   Пример структуры конфигурационного файла:

   resource "yandex_vpc_network" "default" {
     name        = "<имя_сети>"
     description = "<описание_сети>"
     labels = {
       tf-label    = "tf-label-value"
       empty-label = ""
     }
   }
   

   Более подробную информацию о параметрах ресурса vpc_network в Terraform см. в документации провайдера.

2. Проверьте корректность конфигурационных файлов.

   1. В командной строке перейдите в папку, где вы создали конфигурационный файл.

   2. Выполните проверку с помощью команды:

      terraform plan
      

   Если конфигурация описана верно, в терминале отобразится список создаваемых ресурсов и их параметров. Если в конфигурации есть ошибки, Terraform на них укажет.

3. Разверните облачные ресурсы.

   1. Если в конфигурации нет ошибок, выполните команду:

      terraform apply
      

   2. Подтвердите создание ресурсов: введите в терминал слово yes и нажмите Enter.

      После этого в указанном каталоге будут созданы все требуемые ресурсы. Проверить появление ресурсов и их настройки можно в консоли управления или с помощью команд CLI:

      yc vpc network list
      

Чтобы создать облачную сеть, воспользуйтесь методом REST API create для ресурса Network или вызовом gRPC API NetworkService/Create и передайте в запросе:

• Идентификатор каталога, в котором будет размещена сеть, в параметре folderId.
• Имя новой сети в параметре name. Допустимая длина имени — от 3 до 63 символов, последний символ — не дефис.
• Описание новой сети в параметре description. Максимальная длина описания — 256 символов.

Параметры name и description необязательные — можно создать сеть без имени и описания и обращаться к ней по идентификатору.

О том, как узнать идентификатор каталога, читайте в разделе Получение идентификатора каталога.

1. Опишите в конфигурационном файле параметры создаваемой облачной сети:

   resource "yandex_vpc_network" "default" {
     name        = "network-1"
     description = "My first network"
   }
   

   Более подробную информацию о параметрах ресурсов в Terraform см. в документации провайдера.

2. Проверьте корректность конфигурационных файлов.

   1. В командной строке перейдите в папку, где вы создали конфигурационный файл.

   2. Выполните проверку с помощью команды:

      terraform plan
      

   Если конфигурация описана верно, в терминале отобразится список создаваемых ресурсов и их параметров. Если в конфигурации есть ошибки, Terraform на них укажет.

3. Разверните облачные ресурсы.

   1. Если в конфигурации нет ошибок, выполните команду:

      terraform apply
      

   2. Подтвердите создание ресурсов: введите в терминал слово yes и нажмите Enter.

      После этого в указанном каталоге будут созданы все требуемые ресурсы. Проверить появление ресурсов и их настройки можно в консоли управления или с помощью команд CLI:

      yc vpc network list