Запустить рабочий процесс вручную в репозитории SourceCraft

Помимо автоматического запуска рабочих процессов CI/CD по определенным событиям-триггерам вы можете запустить процесс вручную из интерфейса SourceCraft.

Совет

Чтобы использовать одинаковую конфигурацию рабочего процесса CI/CD с разными наборами секретов для тестового и продуктового стендов, настройте окружения. В рабочем процессе выбирайте нужное окружение параметром environment; обращения к секретам в secrets остаются одинаковыми. Запускать процесс должен участник с доступом к секретам выбранного окружения.

Простой запуск

  1. Настройте CI/CD в репозитории.

  2. Откройте главную страницу SourceCraft.

  3. На вкладке Домой в секции Ваша мастерская перейдите в раздел Репозитории и выберите репозиторий.

  4. На странице репозитория в разделе Автоматизации перейдите в секцию CI/CD.

  5. Справа вверху нажмите Новый запуск и настройте запуск:

    1. В поле Ветка или тег для поиска описания рабочего процесса выберите ветку или тег, где находится файл .sourcecraft/ci.yaml с нужным рабочим процессом.

    2. В поле Рабочий процесс выберите рабочий процесс.

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

      Примечание

      После выбора источника описания рабочих процессов в качестве версии кода автоматически выбирается та же ветка или тег. При необходимости измените версию кода независимо от источника описания.

    1. Нажмите Запустить.

  6. Проверьте выполнение рабочего процесса:

    1. На странице репозитория в разделе Код перейдите в секцию CI/CD.
    2. Выберите запущенный рабочий процесс (workflow).
    3. На открывшейся странице будут отображены все задания (tasks) рабочего процесса, шаги задания — кубики (cubes), а также статусы и результаты выполнения.

Запуск с пользовательскими параметрами

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

  1. Настройте CI/CD в репозитории.

  2. Откройте главную страницу SourceCraft.

  3. На вкладке Домой в секции Ваша мастерская перейдите в раздел Репозитории и выберите репозиторий.

  4. На странице репозитория в разделе Код перейдите в секцию Ветки.

  5. Выберите ветку для внесения изменений.

  6. Откройте файл .sourcecraft/ci.yaml.

  7. В правом верхнем углу нажмите Редактировать.

  8. Добавьте в параметры рабочего процесса блок inputs. Например:

    workflows:
  test-workflow:
    inputs:
      username:
        type: string
        required: true
        default: John Doe
        description: Обязательное строковое значение.
      show-name:
        type: bool
        default: true
        description: Опциональное логическое значение true или false. По умолчанию — true.
      language:
        type: choice
        default: Russian
        options:
          - Russian
          - English
          - Chinese
        description: Опциональный выбор значения. По умолчанию — Russian.

    tasks:
      - name: sample-task
        env:
          # Замените на названия элементов из блока inputs,
          # например inputs.username, inputs.show-name, inputs.language.
          NAME: ${{ inputs.<название_первого_элемента_из_блока_inputs> }}
          SHOW_NAME: ${{ inputs.<название_второго_элемента_из_блока_inputs> }}
          LANGUAGE: ${{ inputs.<название_третьего_элемента_из_блока_inputs> }}
        cubes:
          - name: sample-cube
            script:
              - |
                case "$LANGUAGE" in
                    "Russian")
                        echo "Привет, мир!"
                        if [ "$SHOW_NAME" = "true" ]; then
                            echo "Меня зовут $NAME."
                        fi
                        ;;
                    "English")
                        echo "Hello, world!"
                        if [ "$SHOW_NAME" = "true" ]; then
                            echo "My name is $NAME."
                        fi
                        ;;
                    "Chinese")
                        echo "你好，世界！"
                        if [ "$SHOW_NAME" = "true" ]; then
                            echo "我的名字是 $NAME。"
                        fi
                        ;;
                esac

on:
  push: test-workflow

    Где:

    • type — тип параметра. Возможные значения:

      • string — строка.
      • bool — логическое значение true или false.
      • choice — выбор из предустановленных значений.

      Примечание

      Если в конфигурации указан параметр options, необязательно задавать параметр type: choice.

      Если тип не указан и нет параметра options, то тип параметра по умолчанию — string.

    • required — обязательность параметра. Возможные значения: true илиfalse.

    • description — произвольное описание параметра, которое будет отображаться в интерфейсе SourceCraft при ручном запуске рабочего процесса.

    • default — значение параметра по умолчанию. Может быть указано, в том числе, если параметр является обязательным.

    • options — возможные значения для типа параметра choice.

  9. В правом верхнем углу нажмите Сохранить изменения.

  10. В открывшемся окне настройте параметры внесения изменений:

    • В поле Сообщение об изменениях укажите комментарий, который опишет внесенные изменения.
    • В блоке Ветка изменений выберите, в какую ветку внести изменения. При необходимости создайте новую ветку.
    • В блоке Действие после сохранения изменений выберите, как внести изменения: с помощью коммита или предложения изменений.

  11. Подтвердите внесение изменений.

    Если вы решили внести изменения через предложение изменений, завершите его создание.

  12. На странице репозитория в разделе Автоматизации перейдите в секцию CI/CD.

  13. Справа вверху нажмите Новый запуск и настройте запуск:

    1. В поле Ветка или тег для поиска описания рабочего процесса выберите ветку или тег, где находится файл .sourcecraft/ci.yaml с нужным рабочим процессом.

    2. В поле Рабочий процесс выберите рабочий процесс.

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

      Примечание

      После выбора источника описания рабочих процессов в качестве версии кода автоматически выбирается та же ветка или тег. При необходимости измените версию кода независимо от источника описания.

    1. Укажите остальные параметры.
    2. Нажмите Запустить.

  14. Проверьте выполнение рабочего процесса:

    1. На странице репозитория в разделе Код перейдите в секцию CI/CD.
    2. Выберите запущенный рабочий процесс (workflow).
    3. На открывшейся странице будут отображены все задания (tasks) рабочего процесса, шаги задания — кубики (cubes), а также статусы и результаты выполнения.

Совет

В разделе Автоматизации → CI/CD репозитория, а также на странице конкретного запуска для каждого рабочего процесса, запущенного вручную, отображаются значения параметров.

Таким образом, вы можете отличать друг от друга рабочие процессы, запущенные с разными параметрами.

Пример отображения в интерфейсе

image

Полезные ссылки

Предыдущая
Настроить CI/CD
Следующая
Настроить ручное подтверждение заданий