Для публикации действий в 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, выполните приведенные ниже инструкции.
-
На GitHubперейдите на главную страницу репозитория.
-
Перейдите к файлу метаданных действия в вашем репозитории (
action.yml
илиaction.yaml
), и вы увидите баннер для публикации действия в GitHub Marketplace. Нажмите кнопку Создать черновик выпуска. -
В разделе "Действие выпуска" выберите "Опубликовать это действие" в GitHub Marketplace.
Примечание. Флажок "Опубликовать" отключен, если учетная запись, которая владеет репозиторием, еще не приняла соглашение о GitHub Marketplace для разработчика. Если вы владеете репозиторием или являетесь владелец организации, щелкните ссылку,чтобы принять соглашение разработчика GitHub Marketplace, а затем примите это соглашение. Если нет ссылки, отправьте владелец организации ссылку на эту страницу "Действие выпуска" и попросите их принять соглашение.
-
Если метки в файле метаданных содержат какие-либо проблемы, появится сообщение об ошибке. Обновите их, обновив файл метаданных. По завершении вы увидите сообщение "Все в порядке!" .
-
Выберите раскрывающееся меню "Основная категория" и выберите категорию, которая поможет пользователям найти действие в GitHub Marketplace.
-
При необходимости выберите раскрывающееся меню "Другая категория " и выберите вторичную категорию.
-
В поле тега введите версию для действия. Это поможет пользователям узнать, какие изменения или функции включены в выпуск. Пользователи будут видеть версию на странице действия в GitHub Marketplace.
-
В поле заголовка введите название выпуска.
-
Заполните остальные поля и щелкните Опубликовать выпуск. Для публикации необходимо использовать двухфакторную проверку подлинности. Дополнительные сведения см. в разделе Настройка двухфакторной проверки подлинности.
Удаление действия из GitHub Marketplace
Чтобы удалить опубликованное действие из GitHub Marketplace, необходимо обновить каждый опубликованный выпуск. Выполните указанные ниже действия для каждого выпуска действия, опубликованного в GitHub Marketplace.
-
На GitHubперейдите на главную страницу репозитория.
-
Справа от списка файлов щелкните Выпуски.
-
Выберите Опубликовать это действие в GitHub Marketplace, чтобы снять флажок.
-
В нижней части страницы щелкните Обновить выпуск.
Передача репозитория действий
Репозиторий действий можно передать другому пользователю или организации. Дополнительные сведения см. в разделе Передача репозитория.
Когда администратор репозитория передает репозиторий действий, GitHub автоматически создает перенаправление с предыдущего URL-адреса на новый URL-адрес, то есть рабочие процессы, использующие затронутые действия, не нужно обновлять.
Действия, опубликованные на GitHub Marketplace связаны с репозиторием по их уникальному name
идентификатору, что означает, что вы можете публиковать новые выпуски действия из переданного репозитория в том же списке GitHub Marketplace . Если репозиторий действий удален, также удаляется список GitHub Marketplace и уникальный name
идентификатор становится доступным.
Примечание. Значок "Проверенный" в профиле GitHub отличается от проверенного значка создателя на GitHub Marketplace. При передаче репозитория действий список GitHub Marketplace потеряет проверенный значок создателя, если только новый владелец не является проверенным создателем.
Сведения о значках в GitHub Marketplace
Наличие значка (то есть подтвержденный создатель) у действия означает, что создатель действия является подтвержденной партнерской организацией на GitHub. Партнеры могут отправить сообщение электронной почты partnerships@github.com , чтобы запросить проверенный значок создателя.