nick_invision.macos_github_actions_runner
macos-github-actions-runner
Ta rola zainstaluje samodzielnego runnera GitHub Actions na poziomie organizacji lub repozytorium na MacOS/MacOSX. Możesz wykonać czystą instalację, ponownie zainstalować, jeśli chcesz, ponownie zainstalować, jeśli usługa nie działa, lub odinstalować. Inspiracją była rola ansible-github_actions_runner, ale zmodyfikowana, aby działała z MacOS.
Wymagania
Ta rola powinna być używana tylko na MacOS 10.13 (High Sierra) lub nowszym.
Wymagane są następujące zmienne środowiskowe:
PERSONAL_ACCESS_TOKEN
- Osobisty token dostępu GitHub z zakresemrepo
w przypadku dodawania runnera repozytorium lub zakresemadmin:org
w przypadku dodawania runnera organizacji.
Wymagane są następujące zmienne:
github_account
- Nazwa konta GitHub, wrażliwa na wielkość liter. To może być nazwa użytkownika GitHub lub nazwa organizacji GitHub.access_token
- Jest to opcjonalne i zastępuje wymaganą zmienną środowiskowąPERSONAL_ACCESS_TOKEN
.
Zmienne roli
Domyślne wartości (z defaults/main.yml
):
# Użytkownik runnera - użytkownik, pod którym działa lokalna usługa runnera
runner_user: "vagrant"
# Katalog, w którym zostanie zainstalowany lokalny runner
runner_dir: ~/actions-runner
# Wersja runnera GitHub Actions
runner_version: "latest"
# Jeśli znaleziono na serwerze, usuń istniejącą usługę runnera i zainstaluj ją ponownie
reinstall_runner: no
# Nie pokazuj logów Ansible, które mogą zawierać dane wrażliwe (token rejestracyjny)
hide_sensitive_logs: yes
# Adres GitHub
github_url: "https://github.com"
# API GitHub
github_api_url: "https://api.github.com"
# Osobisty token dostępu do twojego konta GitHub
access_token: "{{ lookup('env', 'PERSONAL_ACCESS_TOKEN') }}"
# Czy to jest runner dla organizacji czy nie?
runner_org: no
# Nazwa przypisana do tego runnera w GitHub (domyślnie nazwa hosta systemu)
runner_name: "{{ hostname }}"
# Etykiety do przypisania do runnera
runner_labels: []
# Etykiety do zastosowania w runnerze
runner_work_dir: "_work"
# Dodatkowe argumenty do przekazania do `config.sh`
runner_extra_config_args: ""
Zależności
Brak
Przykład Playbooka
Aby skonfigurować samodzielnego runnera GitHub na poziomie repozytorium:
- name: Zainstaluj runnera GitHub Actions
hosts: macs
user: ansible
become: yes
vars:
- github_account: github-access-user
- github_repo: my_awesome_repo
roles:
- role: nick-invision.macos_github_actions_runner
Aby skonfigurować samodzielnego runnera GitHub na poziomie organizacji:
- name: Zainstaluj runnera GitHub Actions
hosts: macs
user: ansible
become: yes
vars:
- github_account: github-access-user
- runner_org: true
roles:
- role: nick-invision.macos_github_actions_runner
Aby skonfigurować samodzielnego runnera GitHub z różnymi nadpisaniami:
- name: Zainstaluj runnera GitHub Actions
hosts: macs
user: ansible
become: yes
vars:
- github_account: github-access-user
- runner_org: true
- runner_labels:
- some-label
- runner_version: 2.277.0
roles:
- role: nick-invision.macos_github_actions_runner
Licencja
MIT
ansible-galaxy install nick_invision.macos_github_actions_runner