Краткое руководство. Создание рабочего процесса проверки проверки GitHub

Статья
03/05/2024

В этом кратком руководстве вы узнаете, как создать рабочий процесс GitHub для тестирования исходного кода .NET. Автоматическое тестирование кода .NET в GitHub называется непрерывной интеграцией (CI), где запросы на вытягивание или изменения в рабочих процессах исходного триггера для выполнения. Наряду с созданием исходного кода тестирование гарантирует, что скомпилированный исходный код функционирует в качестве автора. Чаще всего модульные тесты служат в качестве немедленного цикла обратной связи, чтобы обеспечить допустимость изменений в исходном коде.

Необходимые компоненты

Учетная запись GitHub.
Репозиторий исходного кода .NET.

Создание файла рабочего процесса

В репозитории GitHub добавьте новый ФАЙЛ YAML в каталог github/workflows . Выберите понятное имя файла, которое четко указывает, что рабочий процесс предназначен для выполнения. Дополнительные сведения см . в файле рабочего процесса.

Внимание

GitHub требует, чтобы файлы композиции рабочих процессов размещались в каталоге github/workflows .

Файлы рабочих процессов обычно определяют композицию одного или нескольких GitHub Action с помощью .jobs.<job_id>/steps[*] Дополнительные сведения см. в синтаксисе рабочего процесса для GitHub Actions.

Создайте файл с именем build-and-test.yml, скопируйте и вставьте в него следующее содержимое YML:

name: build and test

on:
  push:
  pull_request:
    branches: [ main ]
    paths:
    - '**.cs'
    - '**.csproj'

env:
  DOTNET_VERSION: '6.0.401' # The .NET SDK version to use

jobs:
  build-and-test:

    name: build-and-test-${{matrix.os}}
    runs-on: ${{ matrix.os }}
    strategy:
      matrix:
        os: [ubuntu-latest, windows-latest, macOS-latest]

    steps:
    - uses: actions/checkout@v3
    - name: Setup .NET Core
      uses: actions/setup-dotnet@v3
      with:
        dotnet-version: ${{ env.DOTNET_VERSION }}

    - name: Install dependencies
      run: dotnet restore
      
    - name: Build
      run: dotnet build --configuration Release --no-restore
    
    - name: Test
      run: dotnet test --no-restore --verbosity normal

В приведенной выше композиции рабочего процесса:

Определяет name: build and test имя, "сборка и проверка" будет отображаться в индикаторах состояния рабочего процесса.
```
name: build and test
```
Узел on обозначает события, которые активируют рабочий процесс:
```
on:
  push:
  pull_request:
    branches: [ main ]
    paths:
    - '**.cs'
    - '**.csproj'
```
- Активируется при push возникновении или pull_request возникновении main в ветви, в которой все файлы изменились, заканчивая расширениями .cs или CSPROJ-файла .
Узел env определяет именованные переменные среды (env var).
```
env:
  DOTNET_VERSION: '6.0.401' # The .NET SDK version to use
```
- Переменная DOTNET_VERSION среды присваивается значению '6.0.401'. Позже переменная среды ссылается на указание dotnet-versionactions/setup-dotnet@v3 действия GitHub.
Узел jobs создает шаги для выполнения рабочего процесса.
```
jobs:
  build-and-test:

    name: build-and-test-${{matrix.os}}
    runs-on: ${{ matrix.os }}
    strategy:
      matrix:
        os: [ubuntu-latest, windows-latest, macOS-latest]

    steps:
    - uses: actions/checkout@v3
    - name: Setup .NET Core
      uses: actions/setup-dotnet@v3
      with:
        dotnet-version: ${{ env.DOTNET_VERSION }}

    - name: Install dependencies
      run: dotnet restore
      
    - name: Build
      run: dotnet build --configuration Release --no-restore
    
    - name: Test
      run: dotnet test --no-restore --verbosity normal
```
- Существует одно задание с именем build-<os><os> операционной системы из .strategy/matrix Элементы name являются динамическими для каждого значения в элементе matrix/os.runs-on Это будет работать в последних версиях Ubuntu, Windows и macOS.
- Действие actions/setup-dotnet@v3 GitHub используется для настройки пакета SDK для .NET с указанной версией из переменной DOTNET_VERSION среды.
- Вызывается dotnet restore команда.
- Вызывается dotnet build команда.
- Вызывается dotnet test команда.

Создание индикатора состояния рабочего процесса

В репозиториях GitHub обычно используется файл README.md в корне каталога репозитория. Аналогичным образом, приятно сообщить о последнем состоянии для различных рабочих процессов. Все рабочие процессы могут создать значок состояния, который визуально привлекательно в файле README.md . Чтобы добавить значок состояния рабочего процесса, выполните следующие действия.

В репозитории GitHub выберите параметр навигации Actions .
Все рабочие процессы репозитория отображаются слева, выберите нужный рабочий процесс и кнопку с многоточием (...).
- Кнопка с многоточием (...) расширяет параметры меню для выбранного рабочего процесса.
Выберите пункт меню "Создать индикатор состояния".
Нажмите кнопку "Копировать состояние" Markdown .
Вставьте Markdown в файл README.md , сохраните файл, зафиксируйте и отправьте изменения.