---
metadata:
  - name: generator
    content: Diplodoc Platform v5.55.2
alternate:
  - https://sourcecraft.dev/portal/docs/en/sourcecraft/operations/run-workflow-manually.md
  - https://sourcecraft.dev/portal/docs/ru/sourcecraft/operations/run-workflow-manually.md
  - href: ru/sourcecraft/operations/run-workflow-manually.md
    type: text/markdown
    title: Markdown version
  - href: ../../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://sourcecraft.dev/portal/docs/ru/llms.txt

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

Помимо автоматического запуска [рабочих процессов](https://sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/ci-cd.md#workflows) CI/CD по определенным [событиям-триггерам](https://sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/ci-cd.md#on) вы можете запустить процесс вручную из интерфейса SourceCraft.


## Простой запуск {#simple-run}

1. [Настройте](https://sourcecraft.dev/portal/docs/ru/sourcecraft/operations/ci-cd.md) CI/CD в репозитории.
1. Откройте [главную страницу](https://sourcecraft.dev) SourceCraft.
1. На вкладке ![image](../../_assets/console-icons/house.svg) **Домой** в секции ![image](../../_assets/console-icons/layout-tabs.svg) **Ваша мастерская** перейдите в раздел ![image](../../_assets/console-icons/archive.svg) **Репозитории** и выберите репозиторий.
1. На странице репозитория в разделе ![image](../../_assets/console-icons/code.svg) **Код** перейдите в секцию ![image](../../_assets/console-icons/arrows-3-rotate-right.svg) **CI/CD**.
1. Справа вверху нажмите **Новый запуск** и настройте запуск:

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

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

    <!-- source: ru/_includes/sourcecraft/ci-cd/ui-overview.md -->
    1. На странице репозитория в разделе ![image](../../_assets/console-icons/code.svg) **Код** перейдите в секцию ![image](../../_assets/console-icons/arrows-3-rotate-right.svg) **CI/CD**.
    1. Выберите запущенный рабочий процесс (workflow).
    1. На открывшейся странице будут отображены все задания (tasks) рабочего процесса, шаги задания — кубики (cubes), а также статусы и результаты выполнения.
    <!-- endsource: ru/_includes/sourcecraft/ci-cd/ui-overview.md -->


## Запуск с пользовательскими параметрами {#run-with-params}

<!-- source: ru/_includes/sourcecraft/configuration-tip.md -->
{% note tip %}

Настройка и просмотр конфигураций репозитория доступны в интерфейсе SourceCraft в разделе ![image](../../_assets/console-icons/gear.svg) **Настройки репозитория** в секции ![image](../../_assets/console-icons/nut-hex.svg) **Конфигурации**. Подробнее в инструкции [Настроить конфигурации репозитория в виде кода](https://sourcecraft.dev/portal/docs/ru/sourcecraft/operations/configuration-edit.md).

{% endnote %}
<!-- endsource: ru/_includes/sourcecraft/configuration-tip.md -->

1. [Настройте](https://sourcecraft.dev/portal/docs/ru/sourcecraft/operations/ci-cd.md) CI/CD в репозитории.
1. Откройте [главную страницу](https://sourcecraft.dev) SourceCraft.
1. На вкладке ![image](../../_assets/console-icons/house.svg) **Домой** в секции ![image](../../_assets/console-icons/layout-tabs.svg) **Ваша мастерская** перейдите в раздел ![image](../../_assets/console-icons/archive.svg) **Репозитории** и выберите репозиторий.
1. На странице репозитория в разделе ![image](../../_assets/console-icons/code.svg) **Код** перейдите в секцию ![image](../../_assets/console-icons/code-trunk.svg) **Ветки**.
1. Выберите ветку для внесения изменений.
1. Откройте файл `.sourcecraft/ci.yaml`.
1. В правом верхнем углу нажмите ![image](../../_assets/console-icons/pencil.svg) **Редактировать**.
1. Добавьте в параметры рабочего процесса блок [inputs](https://sourcecraft.dev/portal/docs/ru/sourcecraft/ci-cd-ref/workflows.md#inputs). Например:

    ```yaml
    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
    ```

    <!-- source: ru/_includes/sourcecraft/ci-cd/input-configs.md -->
    Где:
    * `type` — тип параметра. Возможные значения:
        * `string` — строка.
        * `bool` — логическое значение `true` или `false`.
        * `choice` — выбор из предустановленных значений. 

        {% note info %}

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

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

        {% endnote %}

    * `required` — обязательность параметра. Возможные значения: `true` или`false`.
    * `description` — произвольное описание параметра, которое будет отображаться в интерфейсе SourceCraft при ручном запуске рабочего процесса.
    * `default` — значение параметра по умолчанию. Может быть указано, в том числе, если параметр является обязательным.
    * `options` — возможные значения для типа параметра `choice`.
    <!-- endsource: ru/_includes/sourcecraft/ci-cd/input-configs.md -->

1. В правом верхнем углу нажмите **Сохранить изменения**.
1. В открывшемся окне настройте параметры внесения изменений:

    * В поле **Сообщение об изменениях** укажите комментарий, который опишет внесенные изменения.
    * В блоке **Ветка изменений** выберите, в какую ветку внести изменения. При необходимости создайте новую ветку.
    * В блоке **Действие после сохранения изменений** выберите, как внести изменения: с помощью коммита или [предложения изменений](https://sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/index.md#pr).

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

    Если вы решили внести изменения через предложение изменений, [завершите](https://sourcecraft.dev/portal/docs/ru/sourcecraft/operations/pr-create.md) его создание.

1. На странице репозитория в разделе ![image](../../_assets/console-icons/code.svg) **Код** перейдите в секцию ![image](../../_assets/console-icons/arrows-3-rotate-right.svg) **CI/CD**.
1. Справа вверху нажмите **Новый запуск** и настройте запуск:

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

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

    <!-- source: ru/_includes/sourcecraft/ci-cd/ui-overview.md -->
    1. На странице репозитория в разделе ![image](../../_assets/console-icons/code.svg) **Код** перейдите в секцию ![image](../../_assets/console-icons/arrows-3-rotate-right.svg) **CI/CD**.
    1. Выберите запущенный рабочий процесс (workflow).
    1. На открывшейся странице будут отображены все задания (tasks) рабочего процесса, шаги задания — кубики (cubes), а также статусы и результаты выполнения.
    <!-- endsource: ru/_includes/sourcecraft/ci-cd/ui-overview.md -->

<!-- source: ru/_includes/sourcecraft/ci-cd/inputs-note.md -->
{% note tip %}

В разделе ![image](../../_assets/console-icons/terminal-line.svg) **Автоматизации** **→** ![image](../../_assets/console-icons/arrows-3-rotate-right.svg) **CI/CD** репозитория, а также на странице конкретного запуска для каждого [рабочего процесса](https://sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/ci-cd.md#workflows), запущенного вручную, отображаются значения параметров.

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

{% cut "Пример отображения в интерфейсе" %}

![image](../../_assets/sourcecraft/manual-workflow-configs.png)

{% endcut %}

{% endnote %}
<!-- endsource: ru/_includes/sourcecraft/ci-cd/inputs-note.md -->

#### Полезные ссылки {#see-also}

* [Настроить CI/CD в репозитории SourceCraft](https://sourcecraft.dev/portal/docs/ru/sourcecraft/operations/ci-cd.md)
* [Непрерывная интеграция и непрерывное развертывание в SourceCraft](https://sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/ci-cd.md)
* [Справочник CI/CD](https://sourcecraft.dev/portal/docs/ru/sourcecraft/ci-cd-ref/index.md)