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

Введение

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

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

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

1. Создайте каталог .github/workflows в своем репозитории в GitHub, если этот каталог еще не существует. В каталоге должно быть точное имя для GitHub для обнаружения всех рабочих процессов GitHub Actions рабочих процессов, содержащихся в ней.

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

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

   YAML

   name: GitHub Actions Demo
   run-name: ${{ github.actor }} is testing out GitHub Actions 🚀
   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@v4
         - 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перейдите на главную страницу репозитория.

2. Под именем репозитория щелкните Actions.

   

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

   

4. В списке запусков рабочих процессов щелкните имя запуска, которое вы хотите увидеть, в этом примере "ИМЯ ПОЛЬЗОВАТЕЛЯ тестирует GitHub Actions".

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

   

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

   

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

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

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

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

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

Следующие шаги

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

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