Skip to main content

Публикация действий в GitHub Marketplace

Вы можете публиковать действия в GitHub Marketplace и предоставлять общий доступ к созданным действиям в сообществе GitHub.

Для публикации действий в GitHub Marketplace необходимо принять условия предоставления услуг.

Сведения о публикации действий

Перед публикацией действия необходимо создать его в репозитории. Дополнительные сведения см. в разделе Совместное использование автоматизации.

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

Действия публикуются в GitHub Marketplace немедленно и не проверяются GitHub при условии соответствия следующим требованиям:

  • Действие должно находиться в общедоступном репозитории.
  • Каждый репозиторий должен содержать одно действие.
  • Каждый репозиторий не_ должен _содержать файлы рабочего процесса.
  • Файл метаданных действия (action.yml или action.yaml) должен находиться в корневом каталоге репозитория.
  • Атрибут name в файле метаданных действия должен быть уникальным.
    • Атрибут name не может совпадать с именем существующего действия, опубликованного в GitHub Marketplace.
    • Атрибут name не может совпадать с именем пользователя или организации на GitHub, если это действие не публикует пользователь или владелец организации. Например, только организация GitHub может опубликовать действие с именем github.
    • Атрибут name не должен совпадать с существующей категорией GitHub Marketplace.
    • Имена функций GitHub на GitHub зарезервированы.

Публикация действия

Вы можете добавить созданное вами действие в GitHub Marketplace, пометив его как новый выпуск и опубликовав.

Чтобы создать черновик нового выпуска и опубликовать действие в GitHub Marketplace, выполните приведенные ниже инструкции.

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

  2. Перейдите к файлу метаданных действия в вашем репозитории (action.yml или action.yaml), и вы увидите баннер для публикации действия в GitHub Marketplace. Нажмите кнопку Создать черновик выпуска.

  3. В разделе "Действие выпуска" выберите "Опубликовать это действие" в GitHub Marketplace.

    Note

    Флажок "Опубликовать" отключен, если учетная запись, которая владеет репозиторием, еще не приняла соглашение о разработчике GitHub Marketplace. Если вы владеете репозиторием или являетесь владелец организации, щелкните ссылку,чтобы принять соглашение разработчика GitHub Marketplace, а затем примите это соглашение. Если нет ссылки, отправьте владелец организации ссылку на эту страницу "Действие выпуска" и попросите их принять соглашение.

  4. Если метки в файле метаданных содержат какие-либо проблемы, появится сообщение об ошибке. Обновите их, обновив файл метаданных. По завершении вы увидите сообщение "Все в порядке!" .

  5. Выберите раскрывающееся меню "Основная категория" и выберите категорию, которая поможет пользователям найти действие в GitHub Marketplace.

  6. При необходимости выберите раскрывающееся меню "Другая категория " и выберите вторичную категорию.

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

  8. В поле заголовка введите название выпуска.

  9. Заполните остальные поля и щелкните Опубликовать выпуск. Для публикации необходимо использовать двухфакторную проверку подлинности. Дополнительные сведения см. в разделе Настройка двухфакторной проверки подлинности.

Удаление действия из GitHub Marketplace

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

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

  2. Справа от списка файлов щелкните Выпуски.

    Снимок экрана: главная страница репозитория. Ссылка, помеченная как "Выпуски", выделена оранжевым контуром.

  3. Выберите Опубликовать это действие в GitHub Marketplace, чтобы снять флажок.

  4. В нижней части страницы щелкните Обновить выпуск.

Передача репозитория действий

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

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

Действия, опубликованные на GitHub Marketplace связаны с репозиторием по их уникальному name идентификатору, что означает, что вы можете публиковать новые выпуски действия из переданного репозитория в том же списке GitHub Marketplace . Если репозиторий действий удален, также удаляется список GitHub Marketplace и уникальный name идентификатор становится доступным.

Note

Значок "Проверено" в профиле GitHub отличается от проверенного значка создателя на GitHub Marketplace. При передаче репозитория действий список GitHub Marketplace потеряет проверенный значок создателя, если только новый владелец не является проверенным создателем.

Сведения о значках в GitHub Marketplace

Наличие значка (то есть подтвержденный создатель) у действия означает, что создатель действия является подтвержденной партнерской организацией на GitHub. Партнеры могут отправить сообщение электронной почты partnerships@github.com , чтобы запросить проверенный значок создателя.

Снимок экрана: GitHub Actions с проверенным значком создателя.