Skip to main content

Использование средств выполнения, размещенных в GitHub

Задание можно назначить для запуска на виртуальной машине, размещенной на GitHubней.

Использование средства выполнения с размещением GitHub

Чтобы использовать GitHubсредство выполнения с размещением, создайте задание и используйте runs-on для указания типа runner, который будет обрабатывать задание, например ubuntu-latest``windows-latest, или macos-latest. Полный список типов runner см. в разделе Справочник по запускам с размещением в GitHub. Если у вас есть repo: write доступ к репозиторию, вы можете просмотреть список средств выполнения, доступных для использования в рабочих процессах в репозитории. Дополнительные сведения см. в разделе "Просмотр доступных средств выполнения" для репозитория.

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

На следующей схеме показано, как два задания в рабочем процессе выполняются на двух разных GitHubузлах выполнения.

Схема рабочего процесса, состоящего из двух заданий. Одно задание выполняется в Ubuntu, а другое выполняется в Windows.

В следующем примере рабочего процесса есть два задания: Run-npm-on-Ubuntu и Run-PSScriptAnalyzer-on-Windows. При активации GitHub этого рабочего процесса подготавливает новую виртуальную машину для каждого задания.

  • Задание Run-npm-on-Ubuntu выполняется на виртуальной машине Linux, так как для параметра runs-on: в задании указано ubuntu-latest.
  • Задание Run-PSScriptAnalyzer-on-Windows выполняется на виртуальной машине Windows, так как для параметра runs-on: в задании указано windows-latest.
YAML
name: Run commands on different operating systems
on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]

jobs:
  Run-npm-on-Ubuntu:
    name: Run npm on Ubuntu
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: actions/setup-node@v4
        with:
          node-version: '14'
      - run: npm help

  Run-PSScriptAnalyzer-on-Windows:
    name: Run PSScriptAnalyzer on Windows
    runs-on: windows-latest
    steps:
      - uses: actions/checkout@v6
      - name: Install PSScriptAnalyzer module
        shell: pwsh
        run: |
          Set-PSRepository PSGallery -InstallationPolicy Trusted
          Install-Module PSScriptAnalyzer -ErrorAction Stop
      - name: Get list of rules
        shell: pwsh
        run: |
          Get-ScriptAnalyzerRule

Во время выполнения задания журналы и выходные данные можно просмотреть в пользовательском интерфейсе GitHub :

Снимок экрана: запуск рабочего процесса. Отображаются шаги для задания Run PSScriptAnalyzer в Windows.

Приложение средства запуска GitHub Actions предоставляется с открытым кодом. Сведения о проблемах можно внести в репозиторий средства выполнения.

Просмотр доступных модулей выполнения для репозитория

Если у вас есть repo: write доступ к репозиторию, вы можете просмотреть список средств выполнения, доступных в репозитории.

  1. На GitHubперейдите на главную страницу репозитория.

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

    Снимок экрана: вкладки для репозитория github/docs. Вкладка "Действия" выделена оранжевым контуром.

  3. В левой боковой панели в разделе "Управление" щелкните Runners.

  4. Просмотрите список доступных модулей выполнения, размещенных на сайте GitHub, для репозитория.

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

Примечание.

Владельцы предприятия и организации и пользователи с разрешением "Управление группами runners и runner" могут создавать runners на этой странице. Чтобы создать нового бегуна, нажмите кнопку Создать runner в правом верхнем углу списка бегунов, чтобы добавить в репозиторий средства выполнения.

Для получения дополнительной информации смотрите Управление большими бегунами и Добавление локальных средств выполнения.

Дополнительные сведения о пользовательских ролях организации см. в разделе Разрешения на кастомные организационные роли.