Краткое руководство по GitHub Actions

Введение

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

В следующем примере показано, как можно автоматически активировать задания GitHub Actions, где они выполняются, и как они могут взаимодействовать с кодом в репозитории.

Создание вашего первого рабочего процесса

1. Создайте каталог .github/workflows в своем репозитории в GitHub, если этот каталог еще не существует.

2. В каталоге .github/workflows создайте файл с именем github-actions-demo.yml. Дополнительные сведения см. в разделе Создание новых файлов.

3. Скопируйте в файл следующее содержимое github-actions-demo.yml YAML:

   YAML

   name: GitHub Actions Demo
   on: [push]
   jobs:
     Explore-GitHub-Actions:
       runs-on: ubuntu-latest
       steps:
         - run: echo "🎉 The job was automatically triggered by a ${{ github.event_name }} event."
         - run: echo "🐧 This job is now running on a ${{ runner.os }} server hosted by GitHub!"
         - run: echo "🔎 The name of your branch is ${{ github.ref }} and your repository is ${{ github.repository }}."
         - name: Check out repository code
           uses: actions/checkout@v3
         - run: echo "💡 The ${{ github.repository }} repository has been cloned to the runner."
         - run: echo "🖥️ The workflow is now ready to test your code on the runner."
         - name: List files in the repository
           run: |
             ls ${{ github.workspace }}
         - run: echo "🍏 This job's status is ${{ job.status }}."

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

   

Фиксация файла рабочего процесса в ветви в вашем репозитории активирует событие push и запускает рабочий процесс.

Просмотр результатов рабочего процесса

1. На экземпляр GitHub Enterprise Server перейдите на главную страницу репозитория. 1. Под именем репозитория щелкните Действия.

   

2. На левой боковой панели щелкните рабочий процесс, который вы хотите отобразить, в этом примере "GitHub Actions Demo".

   

3. В списке запусков рабочих процессов щелкните имя запуска, которое вы хотите увидеть. В этом примере имя пользователя тестируется GitHub Actions.

4. На левой боковой панели страницы выполнения рабочего процесса в разделе Задания щелкните задание Explore-GitHub-Actions .

   

5. В журнале показано, как был обработан каждый из шагов. Чтобы просмотреть сведения о шаге, разверните его.

   

   Например, вы можете просмотреть список файлов в репозитории:

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

Дополнительные начальные рабочие процессы

GitHub предоставляет предварительно настроенные начальные рабочие процессы, которые можно настроить для создания собственного рабочего процесса непрерывной интеграции. GitHub Enterprise Server анализирует код и показывает начальные рабочие процессы CI, которые могут быть полезны для репозитория. Например, если репозиторий содержит код Node.js, вы увидите предложения для проектов Node.js. Начальные рабочие процессы могут быть отправной точкой для создания пользовательского рабочего процесса, или же его можно использовать в том виде, как есть.

Полный список начальных рабочих процессов можно просмотреть в репозитории actions/starter-workflows в экземпляр GitHub Enterprise Server.

Дальнейшие действия

GitHub Actions помогает автоматизировать практически все аспекты процессов разработки приложений. Вы готовы начать работу? Далее приведены некоторые полезные ресурсы для выполнения следующих этапов работы с GitHub Actions.

• Сведения о рабочих процессах непрерывной интеграции (CI) для сборки и тестирования кода см. в разделе Автоматизация сборок и тестов.
• Сведения о сборке и публикации пакетов см. в разделе Публикация пакетов.
• Сведения о развертывании проектов см. в разделе Развертывание.
• Сведения об автоматизации задач и процессов в GitHub см. в разделе Управление проблемами и запросами на вытягивание.
• Примеры, демонстрирующие более сложные функции GitHub Actions, включая многие из приведенных выше вариантов использования, см. в разделе Примеры. Можно просмотреть подробные примеры, которые объясняют, как протестировать код в средстве выполнения, получить доступ к интерфейсу командной строки GitHub и использовать дополнительные функции, такие как параллелизм и матрицы тестирования.