42 lines
1.3 KiB
Markdown
42 lines
1.3 KiB
Markdown
|
# iconserver-deploy
|
||
|
|
|
||
|
|
A playbook to deploy and manage [iconserver](https://github.com/mat/besticon).
|
||
|
|
|
||
|
|
Includes two roles:
|
||
|
|
* docker
|
||
|
|
* iconserver
|
||
|
|
|
||
|
|
## Docker
|
||
|
|
Supported operating systems:
|
||
|
|
* CentOS Stream 9, RHEL 9 and clones
|
||
|
|
* Ubuntu 24
|
||
|
|
* Debian 12
|
||
|
|
|
||
|
|
Earlier versions and other debian-based distributions may not be compatible.
|
||
|
|
(Please check [docker documentation](https://docs.docker.com/engine/install/).)
|
||
|
|
|
||
|
|
## Iconserver
|
||
|
|
The service is deployed via docker-compose config. Two services are deployed:
|
||
|
|
* [iconserver](https://hub.docker.com/r/matthiasluedtke/iconserver)
|
||
|
|
* [nginx](https://hub.docker.com/_/nginx)
|
||
|
|
|
||
|
|
The service is deployed to be available via https using a self-signed certificate.
|
||
|
|
Nginx configuration template can be edited in the role.
|
||
|
|
|
||
|
|
## Deployment
|
||
|
|
|
||
|
|
The project deployment has been developed and tested with `ansible-core 2.17.4`.
|
||
|
|
If you run an earlier version your mileage may vary, but it should be compatible.
|
||
|
|
|
||
|
|
To deploy the configuration the target servers have to be able to reach docker
|
||
|
|
repos and docker hub via internet.
|
||
|
|
|
||
|
|
Ansible config and inventory files are included. Update `inventory.yml` to match
|
||
|
|
your setup.
|
||
|
|
|
||
|
|
After that deploying the service is as simple as running:
|
||
|
|
```bash
|
||
|
|
ansible-playbook deploy.yml
|
||
|
|
```
|
||
|
|
(Add necessary options, like `-u` or `-K` etc.)
|