Подключиться
Yandex Resource Manager

Создание каталога

Статья создана
,
улучшена

    Каталог — это пространство, в котором создаются и группируются ресурсы Yandex Cloud.

    1. В консоли управления выберите облако и нажмите кнопку Create icon Создать каталог.

    2. Введите имя каталога. Требования к имени:

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

    3. (опционально) Введите описание каталога.

    4. Выберите опцию Создать сеть по умолчанию. Будет создана сеть с подсетями в каждой зоне доступности. Также в этой сети будет создана группа безопасности по умолчанию, внутри которой весь сетевой трафик разрешен.

    5. Нажмите кнопку Создать.

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

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

      yc resource-manager folder create --help

    2. Создайте новый каталог:

      • с именем и без описания:

        yc resource-manager folder create \
  --name new-folder
        • Длина — от 3 до 63 символов.
        • Может содержать строчные буквы латинского алфавита, цифры и дефисы.
        • Первый символ — буква. Последний символ — не дефис.

      • с именем и описанием:

        yc resource-manager folder create \
  --name new-folder \
  --description "my first folder with description"

    Чтобы создать каталог, воспользуйтесь методом create для ресурса Folder.

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

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

      • cloud_id — идентификатор облака, в котором будет создан каталог. Необязательный параметр. По умолчанию будет использовано значение, указанное в настройках провайдера.

      • name — имя создаваемого каталога. Обязательный параметр. Требования к имени:

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

      • description — описание каталога. Необязательный параметр.

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

      resource "yandex_resourcemanager_folder" "folder1" {
  cloud_id    = "<идентификатор облака>"
  name        = "<имя создаваемого каталога>"
  description = "<описание каталога>"
}

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

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

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

      2. Проверьте конфигурацию командой:

        terraform validate

        Если конфигурация является корректной, появится сообщение:

        Success! The configuration is valid.

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

        terraform plan

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

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

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

        terraform apply

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

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

      yc resource-manager cloud list