Skip to main content

Синхронизация действий вручную из GitHub.com

Для пользователей, которым требуется доступ к действиям из GitHub.com, можно синхронизировать конкретные действия с вашим предприятием.

Note

GitHubразмещенные в данный момент средства выполнения не поддерживаются в GitHub Enterprise Server. Дополнительные сведения о планируемой поддержке в будущем см. в GitHub public roadmap.

GitHub Actions на GitHub Enterprise Server предназначен для работы в средах без полного доступа к Интернету. По умолчанию рабочие процессы не могут использовать действия с GitHub.com и из GitHub Marketplace.

Рекомендуется включить автоматический доступ ко всем действиям с помощью GitHub Connect для интеграции GitHub Enterprise Server с GitHub Enterprise Cloud. См . раздел AUTOTITLE.

Если вы хотите более строго контролировать, какие действия разрешены в вашей организации, вы можете использовать наше средство открытый код actions-sync для синхронизации отдельных репозиториев действий с GitHub.com с вашим предприятием.

При обновлении GitHub Enterprise Serverпакетные действия автоматически заменяются версиями по умолчанию в пакете обновления. Это может быть не последняя доступная версия. В качестве рекомендации, если вы используете actions-sync для обновления действий, всегда следует повторно запускать actions-sync после любого обновления GitHub Enterprise Server (основное или дополнительное), чтобы убедиться, что действия остаются актуальными.

Сведения о средстве actions-sync

Средство actions-sync должно выполняться на компьютере, который может получить доступ к API GitHub.com и API экземпляра GitHub Enterprise Server экземпляра. Компьютер не должен быть подключен к обоим API одновременно.

Если компьютер имеет доступ к обеим системам одновременно, можно выполнить синхронизацию с помощью одной команды actions-sync sync. Если вы можете получить доступ только к одной системе за раз, можно использовать команды actions-sync pull и push.

Средство actions-sync может скачивать с сайта GitHub.com только действия, которые хранятся в общедоступных репозиториях.

Note

Это actions-sync средство предназначено для использования в системах, где не включено GitHub Connect . При запуске средства в системе с включенным GitHub Connect, может появиться сообщение об ошибке The repository <repo_name> has been retired and cannot be reused. Это означает, что рабочий процесс использовал это действие непосредственно на GitHub.com и пространство имен удаляется на ваш экземпляр GitHub Enterprise Server. См . раздел AUTOTITLE.

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

  • Прежде чем использовать средствоactions-sync, убедитесь, что все целевые организации уже существуют на вашем предприятии. В следующем примере показано, как синхронизировать действия с организацией с именем synced-actions. См . раздел AUTOTITLE.

  • Необходимо создать personal access token в организации, которая может создавать и записывать в репозитории в конечных организациях. См . раздел AUTOTITLE.

  • Если вы хотите синхронизировать пакетные действия в actions организации на ваш экземпляр GitHub Enterprise Server, необходимо быть владельцем actions организации.

    Note

    По умолчанию даже администраторы сайтов не являются владельцами пакетной actions организации.

    Чтобы повысить уровень пользователя до владельца объединенной организации actions, администраторы сайта могут использовать команду ghe-org-admin-promote в административной оболочке. См. раздел [AUTOTITLE и Доступ к административной оболочке (SSH)](/admin/configuration/configuring-your-enterprise/command-line-utilities#ghe-org-admin-promote).

    ghe-org-admin-promote -u USERNAME -o actions
    

Пример. Использование actions-sync средства

В этом примере показано использование actions-sync средства для синхронизации отдельного действия с GitHub.com с корпоративным экземпляром.

Note

В этом примере используется команда, для которой требуется actions-sync sync одновременный доступ к API GitHub.com и API корпоративного экземпляра на компьютере. Если вы можете получить доступ только к одной системе за раз, можно использовать команды actions-sync pull и push. См. раздел actions-sync README.

  1. Скачайте и извлеките последний actions-sync выпуск операционной системы компьютера.

  2. Создайте каталог для хранения файлов кэша для средства.

  3. В терминале перейдите к каталогу bin в каталоге выпуска, который вы только что извлекли. Например:

    cd PATH/TO/gh_DATETIME_OS_ARCHITECTURE/bin
    
  4. Выполните команду actions-sync sync.

    ./actions-sync sync \
      --cache-dir "cache" \
      --destination-token "aabbccddeeffgg" \
      --destination-url "https://my-ghes-instance" \
      --repo-name "actions/stale:synced-actions/actions-stale"
    

    Приведенная выше команда использует следующие аргументы:

    • --cache-dir: каталог кэша на компьютере, на котором выполняется команда.

    • --destination-token: personal access token для конечного экземпляра предприятия.

    • --destination-url: URL-адрес целевого экземпляра предприятия.

    • --repo-name: репозиторий действий для синхронизации. Имеет формат owner/repository:destination_owner/destination_repository.

      • В приведенном выше примере репозиторий actions/stale синхронизируется с репозиторием synced-actions/actions-stale в целевом экземпляре предприятия. Перед выполнением приведенной выше команды на предприятии необходимо создать организацию с именем synced-actions.
      • Если :destination_owner/destination_repository не указан, средство использует исходное имя владельца и репозитория для предприятия. Перед выполнением команды на предприятии необходимо создать организацию, имя которой соответствует имени владельца действия. Для хранения синхронизированных действий на предприятии рекомендуется использовать центральную организацию, так как это означает, что при синхронизации действий разных владельцев вам не придется создавать несколько новых организаций.
      • Вы можете синхронизировать несколько действий, заменив параметр --repo-name на --repo-name-list или --repo-name-list-file. См. раздел actions-sync README.
  5. После создания репозитория действий на предприятии пользователи на предприятии могут использовать целевой репозиторий для ссылки на действие в рабочих процессах. Для примера действия, показанного выше:

    uses: synced-actions/actions-stale@v1
    

    См . раздел AUTOTITLE.