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

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

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

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

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

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

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

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

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

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

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

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

  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. На странице репозитория в разделе Код перейдите в секцию Автоматизации.

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

    1. Выберите ветку, в которой находится файл .sourcecraft/ci.yaml с нужным рабочим процессом.
    2. Выберите рабочий процесс.
    3. Выберите ветку, в которой нужно запустить рабочий процесс.
    4. Укажите остальные параметры.
    5. Нажмите Запустить.

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

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

См. также

Предыдущая
Настроить CI/CD
Следующая
Настроить правила ревью кода