https://github.com/operations-project/site-runner-example-app
An example repo containing server configuration and app code for a Drupal site runner.
https://github.com/operations-project/site-runner-example-app
Last synced: 6 months ago
JSON representation
An example repo containing server configuration and app code for a Drupal site runner.
- Host: GitHub
- URL: https://github.com/operations-project/site-runner-example-app
- Owner: operations-project
- License: mit
- Created: 2025-11-05T14:05:25.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-12-22T13:15:01.000Z (7 months ago)
- Last Synced: 2025-12-22T16:55:56.468Z (7 months ago)
- Language: Shell
- Homepage:
- Size: 135 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Site Runner App Template
An example repo containing server configuration and app code.
## Instructions
This repo was setup in concert with writing the instructions from https://github.com/operations-project/ansible-collection-site-runner/tree/feature/how-to?#how-to
## Variables
To get started you need the following bits of info.
- Server Hostname. Use a FQDN with a DNS record for ease of use.
- GitHub usernames of your server admins.
- Name of your app repository.
- A GitHub token with repo admin privileges. Used for creating self-hosted runners.
To set this up for your own host, just copy this repo and change the following files in the [`ansible`](./ansible) directory:
- [`hosts`](./ansible/hosts) - Define server hostname. Defines your Ansible inventory. See [Ansible Documentation](https://docs.ansible.com/ansible/latest/inventory_guide/intro_inventory.html).
```ini
[operations_host_ddev]
server.mydomain.com ansible_connection=local
```
- [`group_vars/all.yml`](./ansible/group_vars/all.yml) - Define server admins. Add github usernames.
```yml
operations_admin_users:
- jonpugh
```
- [`host_vars/server.mydomain.com.yml`](./ansible/host_vars/server.mydomain.com.yml) - Define which repos go on the server. Rename to match your hostname.
```yml
operations_github_runners:
- runner_repo: operations-project/site-runner-example-app
```
Set the secret variable `operations_github_api_token` to the GitHub token using your preferred secrets management tools.
For example, to use github secrets, you can pass it on the command line in your workflow file:
```
ansible-playbook --extra-vars operations_github_api_token=${{ secrets.REPO_ADMIN_TOKEN }}
```
See [`server.test.yml`](./.github/workflows/server.yml#53)