Связаться с намиПодключиться

Создание конфигурации для продукта Cloud Apps

Статья создана
Обновлена 29 августа 2025 г.

Создать конфигурацию

  1. Авторизуйтесь в кабинете партнера Marketplace.

  2. Перейдите в продукт, для которого хотите создать конфигурацию.

  3. Перейдите на вкладку Конфигурации.

  4. Нажмите Создать конфигурацию.

  5. Выберите, каким способом хотите создать конфигурацию:

    Чтобы создать пустую конфигурацию:

    1. Выберите каталог для сохранения конфигурации. У вас должна быть роль cloudapps.editor на этот каталог.
    2. Укажите имя конфигурации.
    3. (Опционально) Укажите описание конфигурации.

    Чтобы создать конфигурацию на основе уже существующей:

    1. Выберите конфигурацию, на основе которой хотите создать новую.
    2. Выберите каталог для сохранения конфигурации. У вас должна быть роль cloudapps.editor на этот каталог.
    3. Укажите имя конфигурации.
    4. (Опционально) Укажите описание конфигурации.

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

    Чтобы создать конфигурацию с заранее заданным типовым набором полей и ресурсов:

    1. Выберите пресет, на основе которого хотите создать конфигурацию. Пресет — это набор сервисов Yandex Cloud, на базе которых будет работать приложение. На данный момент доступны следующие пресеты:

      • Network Load Balancer + Instance Groups + Managed Service for PostgreSQL;
      • Network Load Balancer + Instance Groups + Managed Service for MySQL®;
      • Network Load Balancer + Instance Groups + Object Storage;
      • Network Load Balancer + Instance Groups.

    2. Выберите каталог для сохранения конфигурации. У вас должна быть роль cloudapps.editor на этот каталог.

    3. Укажите имя конфигурации.

    4. (Опционально) Укажите описание конфигурации.

    5. (Опционально) В блоке Параметры пресета укажите значения параметров по умолчанию для ресурсов, которые будут создаваться во время установки приложения (экземпляра продукта). Образ диска виртуальной машины Instance Groups должен соответствовать требованиям.

Настроить конфигурацию

Добавить артефакт

Добавьте артефакты — образы дисков Yandex Compute Cloud, Docker-образы Yandex Container Registry и используемые приложением статичные файлы, размещенные в бакетах Yandex Object Storage.

Чтобы добавить артефакт:

  1. В списке появится созданная вами конфигурация в статусе Черновик. Выберите ее.
  2. Добавьте артефакты, которые нужны для работы приложения:

    1. Нажмите Добавить артефакт.

    2. Выберите тип артефакта:

      • Образ диска:

        Образы дисков используются для инициализации дисков виртуальных машин Compute Cloud, в том числе в группах ВМ.

        1. Укажите название артефакта.
        2. Выберите образ диска Yandex Compute Cloud. Он должен соответствовать требованиям.
        3. Нажмите Добавить.

      • Образ контейнера:

        Образы контейнеров используются для создания контейнеризованных приложений с помощью Yandex Serverless Containers или Yandex Container Solution.

        1. Укажите название артефакта.
        2. Выберите Docker-образ, загруженный в Yandex Container Registry. Он должен соответствовать требованиям.
        3. Нажмите Добавить.

      • Object Storage:

        Бакеты Object Storage используются для хранения статических файлов версии приложения, таких как логотипы, глобальные файлы конфигурации, исполняемый код функций Yandex Cloud Functions и т.п.

        1. Укажите название артефакта.
        2. Выберите бакет Yandex Object Storage, в котором хранятся файлы, необходимые для корректной работы приложения.
        3. Укажите полный путь к файлу, например prefix/subprefix/data.json.
        4. Нажмите Добавить.

Создать форму

Создайте форму — набор полей, которые будет заполнять пользователь перед установкой приложения. Значения, полученные из полей, можно использовать как при настройке ресурсов приложения, так и во время его выполнения.

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

Чтобы добавить поле:

  1. Перейдите на вкладку Параметры запуска.

  2. Добавьте поле в форму, которую пользователь будет заполнять при установке приложения:

    1. Нажмите Добавить поле.
    2. Укажите параметры поля. Описание параметров полей см. в разделе Справочник полей, доступных для формы продукта Cloud Apps.

Добавить ресурсы

Опишите ресурсы Yandex Cloud, которые пользователь должен создать перед установкой приложения и которые будут автоматически создаваться в каталоге пользователя при развертывании приложения.

Если вы создавали конфигурацию на основе другой конфигурации или на основе пресета, в конфигурацию уже добавлены ресурсы. Измените их при необходимости.

Чтобы добавить ресурс:

  1. Перейдите на вкладку Ресурсы.

  2. Нажмите Добавить ресурс.

  3. Выберите:

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

  4. Выберите ресурс из доступных.

  5. В правой части окна выберите добавленный ресурс. Ресурсы пользователя отличаются от новых значком .

  6. Измените название ресурса. Для этого нажмите рядом с именем ресурса, которое было сгенерировано автоматически. Имя ресурса должно быть уникальным в рамках конфигурации. Пользователь увидит его при установке приложения.

  7. Укажите параметры ресурса. Возможные типы значений параметров:

    • Значение — статическое значение, которое вы укажете в поле.
    • Атрибут приложения — значение одного из атрибутов приложения, например идентификатор каталога, в котором пользователь будет устанавливать приложение.
    • Референс — значение одного из параметров добавленного вами ресурса.
    • Поле ввода — значение, полученное из поля формы, которую пользователь заполняет при установке приложения.
    • Без значения — пустое значение.
    • Ресурс — выбор одного из добавленных вами ресурсов.
    • Выражение — вычисляемое выражение, позволяющее динамически формировать значение поля на основе других значений, входных параметров и вычислений.

    Описание параметров ресурсов см. в документации Terraform-провайдера. Параметры, доступные при создании ресурсов, и параметры, описанные в документации, могут различаться.

    Пример добавления ресурса
    1. Выберите тип ресурса — VPC облачная сеть.
    2. Нажмите рядом с именем облачной сети yandex-vpc-network-1 — оно было сгенерировано автоматически. Измените имя облачной сети. Оно должно быть уникальным в рамках конфигурации. Указанное вами имя пользователь увидит при установке приложения.
    3. В поле Id выберите Поле ввода и выберите, из какой переменной получать идентификатор облачной сети. Имя переменной указывается при добавлении поля в форму. Пользователь указывает значение поля при установке приложения.

  8. Нажмите Сохранить, чтобы сохранить конфигурацию.

См. также

Предыдущая
Интеграция с License Manager API
Следующая
Заявки на доступ к продуктам