mirror of
https://github.com/semaphoreui/semaphore.git
synced 2024-11-23 20:35:24 +01:00
102 lines
3.9 KiB
Markdown
102 lines
3.9 KiB
Markdown
# Ansible Semaphore
|
|
|
|
[](https://snapcraft.io/semaphore)
|
|
[](https://gitter.im/AnsibleSemaphore/semaphore?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
|
|
|
|
[](https://twitter.com/semaphoreui)
|
|
|
|
[](https://ko-fi.com/fiftin)
|
|
|
|
Ansible Semaphore is a modern UI for Ansible. It lets you easily run Ansible playbooks, get notifications about fails, control access to deployment system.
|
|
|
|
If your project has grown and deploying from the terminal is no longer for you then Ansible Semaphore is what you need.
|
|
|
|
|
|
|
|
## Installation
|
|
|
|
### Full documentation
|
|
https://docs.ansible-semaphore.com/administration-guide/installation
|
|
|
|
### Snap
|
|
|
|
```bash
|
|
sudo snap install semaphore
|
|
sudo semaphore user add --admin --name "Your Name" --login your_login --email your-email@examaple.com --password your_password
|
|
```
|
|
[](https://snapcraft.io/semaphore)
|
|
|
|
### Docker
|
|
|
|
https://hub.docker.com/r/semaphoreui/semaphore
|
|
|
|
`docker-compose.yml` for minimal configuration:
|
|
|
|
```yaml
|
|
services:
|
|
semaphore:
|
|
ports:
|
|
- 3000:3000
|
|
image: semaphoreui/semaphore:latest
|
|
environment:
|
|
SEMAPHORE_DB_DIALECT: bolt
|
|
SEMAPHORE_ADMIN_PASSWORD: changeme
|
|
SEMAPHORE_ADMIN_NAME: admin
|
|
SEMAPHORE_ADMIN_EMAIL: admin@localhost
|
|
SEMAPHORE_ADMIN: admin
|
|
volumes:
|
|
- /path/to/data/home:/etc/semaphore # config.json location
|
|
- /path/to/data/lib:/var/lib/semaphore # database.boltdb location (Not required if using mysql or postgres)
|
|
```
|
|
|
|
## Demo
|
|
|
|
You can test latest version of Semaphore on https://demo.ansible-semaphore.com.
|
|
|
|
## Docs
|
|
|
|
Admin and user docs: https://docs.ansible-semaphore.com
|
|
|
|
API description: https://ansible-semaphore.com/api-docs/
|
|
|
|
## Contributing
|
|
|
|
If you want to write an article about Ansible or Semaphore, contact [@fiftin](https://github.com/fiftin) and we will place your article in our [Blog](https://www.ansible-semaphore.com/blog/) with link to your profile.
|
|
|
|
PR's & UX reviews are welcome!
|
|
|
|
Please follow the [contribution](https://github.com/ansible-semaphore/semaphore/blob/develop/CONTRIBUTING.md) guide. Any questions, please open an issue.
|
|
|
|
## Release Signing
|
|
|
|
All releases after 2.5.1 are signed with the gpg public key
|
|
`8CDE D132 5E96 F1D9 EABF 17D4 2C96 CF7D D27F AB82`
|
|
|
|
## Support
|
|
|
|
If you like Ansible Semaphore, you can support the project development on [Ko-fi](https://ko-fi.com/fiftin).
|
|
|
|
## License
|
|
|
|
MIT License
|
|
|
|
Copyright (c) 2016 Castaway Consulting LLC
|
|
|
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
of this software and associated documentation files (the "Software"), to deal
|
|
in the Software without restriction, including without limitation the rights
|
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
copies of the Software, and to permit persons to whom the Software is
|
|
furnished to do so, subject to the following conditions:
|
|
|
|
The above copyright notice and this permission notice shall be included in all
|
|
copies or substantial portions of the Software.
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
SOFTWARE.
|