{"id":19002783,"url":"https://github.com/teamapps-org/ansible-collection-teamapps-general","last_synced_at":"2025-04-22T18:10:50.056Z","repository":{"id":43483044,"uuid":"365226238","full_name":"teamapps-org/ansible-collection-teamapps-general","owner":"teamapps-org","description":"Ansible Collection for different tools of an organization or company","archived":false,"fork":false,"pushed_at":"2025-04-07T14:34:35.000Z","size":1334,"stargazers_count":8,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-17T08:59:54.200Z","etag":null,"topics":["ansible","ansible-collection","monitoring","prometheus","victoriametrics"],"latest_commit_sha":null,"homepage":"","language":"Jinja","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/teamapps-org.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}},"created_at":"2021-05-07T12:27:48.000Z","updated_at":"2025-04-07T14:34:38.000Z","dependencies_parsed_at":"2023-02-17T04:02:38.637Z","dependency_job_id":"dca4c1c6-d952-447f-af9c-855f2bcd8188","html_url":"https://github.com/teamapps-org/ansible-collection-teamapps-general","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teamapps-org%2Fansible-collection-teamapps-general","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teamapps-org%2Fansible-collection-teamapps-general/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teamapps-org%2Fansible-collection-teamapps-general/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teamapps-org%2Fansible-collection-teamapps-general/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/teamapps-org","download_url":"https://codeload.github.com/teamapps-org/ansible-collection-teamapps-general/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250296175,"owners_count":21407037,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["ansible","ansible-collection","monitoring","prometheus","victoriametrics"],"created_at":"2024-11-08T18:16:21.446Z","updated_at":"2025-04-22T18:10:50.027Z","avatar_url":"https://github.com/teamapps-org.png","language":"Jinja","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Ansible Collection - teamapps.general\n\ngeneric roles for different tools of an organization or company\n\n## Installation\n\n[Official Ansible Documentation for using collections](https://docs.ansible.com/ansible/latest/user_guide/collections_using.html)\n\nAdd to your `requirements.yml`:\n\n~~~yaml\n# requirements.yml\n\ncollections:\n  # current unreleased from git source, requires ansible 2.10 or higher\n  - name: git+https://github.com/teamapps-org/ansible-collection-teamapps-general.git\n    type: git\n    version: main\n~~~\n\nRun `ansible-galaxy collection install -r requirements.yml -f`\n\nTip: You can specify the installation path for collections in your project in `ansible.cfg` before running the command above.\n\n~~~ini\n# ansible.cfg\n[defaults]\ncollections_path = collections\n~~~\n\n## Usage\n\nThe roles in this collection can be used by using their full name, prefixed with `teamapps.general`\n\nCheck the `defaults.yml` of the roles for information on how to configure them.\n\n~~~yaml\n# Ansible Playbook\n# site.yml\n\n- name: Zammad Helpdesk Play\n  hosts: yourhost.example.com\n  vars:\n    letsencrypt_email: mail@example.com\n    zammad_domain: help.example.com\n  roles:\n    - role: teamapps.general.webproxy\n    - role: teamapps.general.zammad\n      tags: zammad\n\n~~~\n\n## Development setup\n\nWe use [pipenv](https://pipenv.readthedocs.io) to install ansible and dependency package.\n\n### First time Setup\n\nThis is my current way I do it on Ubuntu. There are other ways to install ansible and manage the python dependencies.\n\n~~~bash\ncd ansible-collection-teamapps-general # where you cloned this repository\nsudo apt install python3-pip\n# set PATH so it includes user's ~/.local/bin\necho $PATH | grep '\\.local/bin' || echo 'export PATH=\"$HOME/.local/bin:$PATH\"' \u003e\u003e ~/.profile \u0026\u0026 export PATH=\"$HOME/.local/bin:$PATH\"\npip3 install --user --upgrade pip pipenv\npipenv shell --three\npipenv sync\n# check ansible working correctly\nansible --version\n~~~\n\n### Loading pipenv\n\n~~~bash\ncd ansible-collection-teamapps-general # where you cloned this repository\npipenv shell\n~~~\n\n### update ansible and other python packages\n\n* Update your pip and pipenv packages: `pip3 install --user --upgrade pip pipenv`\n* To update your local packages to what's defined in the Pipfile and Pipfile.lock, run `pipenv sync`\n* To update the Pipfile.lock, run `pipenv update`\n* For a major upgrade of ansible, you will get a warning. use `pipenv --rm` and then `pipenv sync`\n\n### Run checks\n\nCheck YAML and ansible syntax\n\n~~~bash\nansible-lint roles/*\n~~~\n\n## License\n\nApache 2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteamapps-org%2Fansible-collection-teamapps-general","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fteamapps-org%2Fansible-collection-teamapps-general","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteamapps-org%2Fansible-collection-teamapps-general/lists"}