{"id":39681710,"url":"https://github.com/plugorgau/plug-services","last_synced_at":"2026-01-18T09:53:36.448Z","repository":{"id":73652516,"uuid":"125803891","full_name":"plugorgau/plug-services","owner":"plugorgau","description":"Deploy PLUG services via Ansible","archived":false,"fork":false,"pushed_at":"2025-11-23T04:20:54.000Z","size":205,"stargazers_count":3,"open_issues_count":16,"forks_count":1,"subscribers_count":11,"default_branch":"main","last_synced_at":"2025-11-23T06:12:22.482Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Jinja","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/plugorgau.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2018-03-19T05:04:12.000Z","updated_at":"2025-11-23T04:20:57.000Z","dependencies_parsed_at":"2025-08-06T12:08:52.088Z","dependency_job_id":"38b3de7d-472b-4ef7-849d-36145de42353","html_url":"https://github.com/plugorgau/plug-services","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/plugorgau/plug-services","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plugorgau%2Fplug-services","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plugorgau%2Fplug-services/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plugorgau%2Fplug-services/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plugorgau%2Fplug-services/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/plugorgau","download_url":"https://codeload.github.com/plugorgau/plug-services/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plugorgau%2Fplug-services/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28534178,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-18T00:39:45.795Z","status":"online","status_checked_at":"2026-01-18T02:00:07.578Z","response_time":98,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-18T09:53:36.369Z","updated_at":"2026-01-18T09:53:36.433Z","avatar_url":"https://github.com/plugorgau.png","language":"Jinja","funding_links":[],"categories":[],"sub_categories":[],"readme":"plug-services\n=============\n\nDeploy PLUG services via Ansible\n\nGetting Started\n===============\n\nRequirements\n------------\n* Control Machine running Ansible 2.2+ and sshpass\n\n* Client machines running Ubuntu 16.04+ or Debian 8+ (we only officially support Debian 9 right now)\n\n* Access to the secrets repo (for now)\n\nUsage\n-----\n\n### First-time usage:\n* Install Ansible 2.2+ and sshpass on your workstation\n\n* (Optionally) Enter a Projects folder to keep it contained\n\n* Clone the plug-services repositories\n\n```sh\ngit clone https://github.com/plugorgau/plug-services.git`\ngit clone git@github.com:plugorgau/plug-services-secrets.git\n```\n\n* Follow the instructions for [the plug-services-secrets repository](https://github.com/plugorgau/plug-services-secrets)\n\n### Bootstrapping new nodes:\n\nTo bootstrap a new node, use the bootstrap keypair when creating it, ensure it is listed in the bootstrap inventory file (bootstrap), then run the below command replacing \"user\" with the initial user - this should be something like \"ubuntu\" or \"admin\". If your user requires a password for login or sudo access, add --ask-pass and --ask-become-pass as appropriate.\n\n```sh\nansible-playbook bootstrap.yml -u user -i bootstrap\n```\n\nOnce the bootstrap playbook has completed, login as the glass management user (\"glass\") and check out plug-services and plug-services-secrets in the home directory, once again following the instructions for [the plug-services-secrets repository](https://github.com/plugorgau/plug-services-secrets).\n\n### Performing a standard run:\n\nOnce keys are in place, running the playbook is simple. On the new host, change directory to plug-services, then...\n\n```sh\nansible-playbook site.yml -i inventory\n```\n\nYou may also find it handy to do a \"dry run\" using Ansible's check mode:\n\n```sh\nansible-playbook site.yml -i inventory --check\n```\n\n**Please note**: Currently the initial Ansible run will fail due to the EFS Backups vol not being mounted. Do a run, then follow post-deployment items, then do a second run. If you are running this outside of AWS, you may need to create a dummy /srv/backup/borg-power folder.\n\n### Post-deployment items:\n\nAfter first boot + first run, there are a few necessary tasks.\n\n* Mount /srv/efs/ and /srv/backup volumes\n* Set hostname and reboot\n* Mount latest borg backup\n* Pluck an LDAP backup from backups, restore it with restoreLDAP.sh\n* Pluck /etc/letsencrypt from backups\n* Run certbot with no args, admin@plug.org.au, for bayonet, no redirects\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplugorgau%2Fplug-services","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fplugorgau%2Fplug-services","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplugorgau%2Fplug-services/lists"}