diff --git a/roles/snipe_it/README.md b/roles/snipe_it/README.md new file mode 100644 index 0000000..dbf12f1 --- /dev/null +++ b/roles/snipe_it/README.md @@ -0,0 +1,43 @@ +# `finallycoffee.services.snipe_it` ansible role + +[Snipe-IT](https://snipeitapp.com/) is an open-source asset management with +a powerful JSON-REST API. This ansible role deploys and configures Snipe-IT. + +## Requirements + +Snipe-IT requires a MySQL-Database like MariaDB and a working email service +for sending email. For installing and configuring MariaDB, see +[`finallycoffee.base.mariadb`](https://galaxy.ansible.com/ui/repo/published/finallycoffee/base/content/role/mariadb/). + +## Configuration + +- `snipe_it_config_app_url` +- `snipe_it_config_app_key` + +### Database configuration + +All (database) options from the upstream laravel `.env` file are available +under the `snipe_it_config_db_*` prefix. Configure a database as follows: +``` +snipe_it_config_db_host: localhost # defaults to localhost +snipe_it_config_db_port: "3306" # defaults to 3306 +snipe_it_config_db_database: my_snipe_db_name # defaults to 'snipeit' +snipe_it_config_db_username: my_snipe_db_user # defaults to 'snipeit' +snipe_it_config_db_password: my_snipe_db_password +# Set this if the database is shared with +# other applications. defaults to not set +snipe_it_config_db_prefix: snipe_ +``` + +### Email configuration + +Configuring an email server is mandatory. An example is provided below: +```yaml +snipe_it_config_mail_host: smtp.example.com +snipe_it_config_mail_username: snipe_user@snipe.example.com +snipe_it_config_mail_password: i_want_to_be_strong_and_long +snipe_it_config_mail_from_addr: "noreply@snipe.example.com" +snipe_it_config_mail_from_name: "Example.com SnipeIT instance" +``` + +The default smtp port is `587` and can be set in `snipe_it_config_mail_port`. diff --git a/roles/snipe_it/defaults/main/config.yml b/roles/snipe_it/defaults/main/config.yml new file mode 100644 index 0000000..cb94d53 --- /dev/null +++ b/roles/snipe_it/defaults/main/config.yml @@ -0,0 +1,133 @@ +--- +snipe_it_config_app_version: "v{{ snipe_it_version }}" +snipe_it_config_app_port: 8000 +snipe_it_config_app_env: "production" +snipe_it_config_app_debug: false +snipe_it_config_app_key: ~ +snipe_it_config_app_url: "http://localhost:{{ snipe_it_config_app_port }}" +snipe_it_config_app_timezone: UTC +snipe_it_config_app_locale: en-US +snipe_it_config_app_locked: false +snipe_it_config_app_cipher: "AES-256-GCM" +snipe_it_config_app_force_tls: false +snipe_it_config_app_trusted_proxies: + - '192.168.0.0/16' + - '172.16.0.0/12' + - '10.0.0.0/8' + +snipe_it_config_db_connection: mysql +snipe_it_config_db_host: localhost +snipe_it_config_db_port: "3306" +snipe_it_config_db_database: snipeit +snipe_it_config_db_username: snipeit +snipe_it_config_db_password: ~ +snipe_it_config_db_prefix: ~ +snipe_it_config_db_dump_path: /usr/bin/ +snipe_it_config_db_charset: utf8mb4 +snipe_it_config_db_collation: utf8mb4_unicode_ci +snipe_it_config_db_ssl: false +snipe_it_config_db_ssl_is_paas: false +snipe_it_config_db_ssl_key_path: ~ +snipe_it_config_db_ssl_cert_path: ~ +snipe_it_config_db_ssl_ca_path: ~ +snipe_it_config_db_ssl_cipher: ~ +snipe_it_config_db_ssl_verify_server: ~ + +snipe_it_config_mail_mailer: smtp +snipe_it_config_mail_host: ~ +snipe_it_config_mail_port: 587 +snipe_it_config_mail_username: ~ +snipe_it_config_mail_password: ~ +snipe_it_config_mail_tls_verify_peer: true +snipe_it_config_mail_from_addr: ~ +snipe_it_config_mail_from_name: ~ +snipe_it_config_mail_replyto_addr: "{{ snipe_it_config_mail_from_addr }}" +snipe_it_config_mail_replyto_name: "{{ snipe_it_config_mail_from_name }}" +snipe_it_config_mail_auto_embed_method: attachment +snipe_it_config_mail_backup_notification_driver: ~ +snipe_it_config_mail_backup_notification_address: ~ + +snipe_it_config_private_filesystem_disk: >-2 + {{ snipe_it_data_directory }}/uploads/private +snipe_it_config_public_filesystem_disk: >-2 + {{ snipe_it_data_directory }}/uploads/public +snipe_it_config_allow_backup_delete: false +snipe_it_config_allow_data_purge: false +snipe_it_config_image_lib: 'gd' + +snipe_it_config_log_channel: 'stderr' +snipe_it_config_log_max_days: 10 + +snipe_it_config_cookie_name: ".snipeit_session" +snipe_it_config_cookie_domain: "{{ snipe_it_domain }}" +snipe_it_config_secure_cookies: true + +snipe_it_config_session_driver: file +snipe_it_config_session_lifetime: 12000 +snipe_it_config_cache_driver: file +snipe_it_config_cache_prefix: snipeit +snipe_it_config_queue_driver: file + +snipe_it_base_config: + APP_VERSION: "{{ snipe_it_config_app_version }}" + APP_PORT: "{{ snipe_it_config_app_port }}" + APP_ENV: "{{ snipe_it_config_app_env }}" + APP_DEBUG: "{{ snipe_it_config_app_debug }}" + APP_KEY: "{{ snipe_it_config_app_key }}" + APP_URL: "{{ snipe_it_config_app_url }}" + APP_TIMEZONE: "{{ snipe_it_config_app_timezone }}" + APP_LOCALE: "{{ snipe_it_config_app_locale }}" + APP_LOCKED: "{{ snipe_it_config_app_locked }}" + APP_CIPHER: "{{ snipe_it_config_app_cipher }}" + APP_FORCE_TLS: "{{ snipe_it_config_app_force_tls }}" + APP_TRUSTED_PROXIES: "{{ snipe_it_config_app_trusted_proxies | join(',') }}" + DB_CONNECTION: "{{ snipe_it_config_db_connection }}" + DB_HOST: "{{ snipe_it_config_db_host }}" + DB_PORT: "{{ snipe_it_config_db_port }}" + DB_DATABASE: "{{ snipe_it_config_db_database }}" + DB_USERNAME: "{{ snipe_it_config_mail_username }}" + DB_PASSWORD: "{{ snipe_it_config_db_password }}" + DB_PREFIX: "{{ snipe_it_config_db_prefix }}" + DB_DUMP_PATH: "{{ snipe_it_config_db_dump_path }}" + DB_CHARSET: "{{ snipe_it_config_db_charset }}" + DB_COLLATION: "{{ snipe_it_config_db_collation }}" + DB_SSL: "{{ snipe_it_config_db_ssl }}" + DB_SSL_IS_PAAS: "{{ snipe_it_config_db_ssl_is_paas }}" + DB_SSL_KEY_PATH: "{{ snipe_it_config_db_ssl_key_path }}" + DB_SSL_CERT_PATH: "{{ snipe_it_config_db_ssl_cert_path }}" + DB_SSL_CA_PATH: "{{ snipe_it_config_db_ssl_ca_path }}" + DB_SSL_CIPHER: "{{ snipe_it_config_db_ssl_cipher }}" + DB_SSL_VERIFY_SERVER: "{{ snipe_it_config_db_ssl_verify_server }}" + MAIL_MAILER: "{{ snipe_it_config_mail_mailer }}" + MAIL_HOST: "{{ snipe_it_config_mail_host }}" + MAIL_PORT: "{{ snipe_it_config_mail_port }}" + MAIL_USERNAME: "{{ snipe_it_config_mail_username }}" + MAIL_PASSWORD: "{{ snipe_it_config_mail_password }}" + MAIL_TLS_VERIFY_PEER: "{{ snipe_it_config_mail_tls_verify_peer }}" + MAIL_FROM_ADDR: "{{ snipe_it_config_mail_from_addr }}" + MAIL_FROM_NAME: "{{ snipe_it_config_mail_from_name }}" + MAIL_REPLYTO_ADDR: "{{ snipe_it_config_mail_replyto_addr }}" + MAIL_REPLYTO_NAME: "{{ snipe_it_config_mail_replyto_name }}" + MAIL_AUTO_EMBED_METHOD: "{{ snipe_it_config_mail_auto_embed_method }}" + MAIL_BACKUP_NOTIFICATION_DRIVER: "{{ snipe_it_config_mail_backup_notification_driver }}" + MAIL_BACKUP_NOTIFICATION_ADDRESS: "{{ snipe_it_config_mail_backup_notification_address }}" + SESSION_DRIVER: "{{ snipe_it_config_session_driver }}" + SESSION_LIFETIME: "{{ snipe_it_config_session_lifetime }}" + CACHE_DRIVER: "{{ snipe_it_config_cache_driver }}" + CACHE_PREFIX: "{{ snipe_it_config_cache_prefix }}" + QUEUE_DRIVER: "{{ snipe_it_config_queue_driver }}" + PRIVATE_FILESYSTEM_DISK: "{{ snipe_it_config_private_filesystem_disk }}" + PUBLIC_FILESYSTEM_DISK: "{{ snipe_it_config_public_filesystem_disk }}" + ALLOW_BACKUP_DELETE: "{{ snipe_it_config_allow_backup_delete }}" + ALLOW_DATA_PURGE: "{{ snipe_it_config_allow_data_purge }}" + IMAGE_LIB: "{{ snipe_it_config_image_lib }}" + LOG_CHANNEL: "{{ snipe_it_config_log_channel }}" + LOG_MAX_DAYS: "{{ snipe_it_config_log_max_days }}" + COOKIE_NAME: "{{ snipe_it_config_cookie_name }}" + COOKIE_DOMAIN: "{{ snipe_it_config_cookie_domain }}" + SECURE_COOKIES: "{{ snipe_it_config_secure_cookies }}" + +snipe_it_config: ~ +snipe_it_merged_config: >-2 + {{ snipe_it_base_config | default({}, true) + | combine(snipe_it_config | default({}, true), recursive=True) }} diff --git a/roles/snipe_it/defaults/main/container.yml b/roles/snipe_it/defaults/main/container.yml new file mode 100644 index 0000000..08d10ed --- /dev/null +++ b/roles/snipe_it/defaults/main/container.yml @@ -0,0 +1,33 @@ +--- +snipe_it_container_container_image_registry: docker.io +snipe_it_container_container_image_namespace: snipe +snipe_it_container_container_image_name: 'snipe-it' +snipe_it_container_container_image_tag: ~ +snipe_it_container_container_image_flavour: alpine +snipe_it_container_container_image_source: pull +snipe_it_container_container_image_force_source: >-2 + {{ snipe_it_container_container_image_tag | default(false, true) | bool }} +snipe_it_container_container_image: >-2 + {{ + ([ + snipe_it_container_container_image_registry | default([], true), + snipe_it_container_container_image_namespace | default([], true), + snipe_it_container_container_image_name, + ] | flatten | join('/')) + + ':' + + (vaultwarden_container_image_tag | default( + 'v' + vaultwarden_version + ( + ((snipe_it_container_container_image_flavour is string) + and (snipe_it_container_container_image_flavour | length > 0)) + | ternary( + '-' + snipe_it_container_container_image_flavour | default('', true), + '' + ) + ), + true + )) + }} + +snipe_it_container_env_file: "{{ snipe_it_env_file }}" +snipe_it_container_user: ~ +snipe_it_container_ #TODO diff --git a/roles/snipe_it/defaults/main/main.yml b/roles/snipe_it/defaults/main/main.yml new file mode 100644 index 0000000..c9f2ec5 --- /dev/null +++ b/roles/snipe_it/defaults/main/main.yml @@ -0,0 +1,8 @@ +--- +snipe_it_user: snipeit +snipe_it_version: "7.0.13" +snipe_it_state: present +snipe_it_deployment_method: docker + +snipe_it_env_file: /etc/snipeit/env +snipe_it_data_directory: /var/lib/snipeit diff --git a/roles/snipe_it/defaults/main/user.yml b/roles/snipe_it/defaults/main/user.yml new file mode 100644 index 0000000..8faf98b --- /dev/null +++ b/roles/snipe_it/defaults/main/user.yml @@ -0,0 +1,5 @@ +--- +snipe_it_run_user_id: >-2 + {{ snipe_it_user_info.uid | default(snipe_it_user) }} +snipe_it_run_group_id: >-2 + {{ snipe_it_user_info.group | default(snipe_it_user) }} diff --git a/roles/snipe_it/meta/main.yml b/roles/snipe_it/meta/main.yml new file mode 100644 index 0000000..539582c --- /dev/null +++ b/roles/snipe_it/meta/main.yml @@ -0,0 +1,12 @@ +--- +allow_duplicates: true +dependencies: [] +galaxy_info: + role_name: snipe_it + description: >-2 + Deploy Snipe-IT, an open-source asset / license management system with + powerful JSON REST API + galaxy_tags: + - snipeit + - asset-management + - docker diff --git a/roles/snipe_it/tasks/check.yml b/roles/snipe_it/tasks/check.yml new file mode 100644 index 0000000..8fec363 --- /dev/null +++ b/roles/snipe_it/tasks/check.yml @@ -0,0 +1,14 @@ +--- +- name: Ensure state is valid + ansible.builtin.fail: + msg: >-2 + Unsupported state '{{ snipe_it_state }}'! + Supported states are {{ snipe_it_states | join(', ') }}. + when: snipe_it_state is not in snipe_it_states + +- name: Ensure deployment method is valid + ansible.builtin.fail: + msg: >-2 + Unsupported deployment_method '{{ snipe_it_deployment_method }}'! + Supported values are {{ snipe_it_deployment_methods | join(', ') }}. + when: snipe_it_deployment_method is not in snipe_it_deployment_methods diff --git a/roles/snipe_it/tasks/deploy-docker.yml b/roles/snipe_it/tasks/deploy-docker.yml new file mode 100644 index 0000000..9614e70 --- /dev/null +++ b/roles/snipe_it/tasks/deploy-docker.yml @@ -0,0 +1,18 @@ +--- +- name: Ensure container image '{{ snipe_it_container_image }}' is {{ snipe_it_state }} + community.docker.docker_image: + name: "{{ snipe_it_container_image }}" + state: "{{ snipe_it_state }}" + source: "{{ snipe_it_container_image_source }}" + force_source: "{{ snipe_it_container_image_force_source }}" + register: snipe_it_container_image_info + until: snipe_it_container_image_info is success + retries: 5 + delay: 3 + +- name: Ensure container '{{ snipe_it_container_name }}' is {{ snipe_it_container_state }} + community.docker.docker_container: + name: "{{ snipe_it_container_name }}" + image: "{{ snipe_it_container_image }}" + # more args + state: "{{ snipe_it_container_state }}" diff --git a/roles/snipe_it/tasks/main.yml b/roles/snipe_it/tasks/main.yml new file mode 100644 index 0000000..2550e8a --- /dev/null +++ b/roles/snipe_it/tasks/main.yml @@ -0,0 +1,59 @@ +--- +- name: Check preconditions + ansible.builtin.include_tasks: + file: "check.yml" + +- name: Ensure snipe-it user '{{ snipe_it_user }}' is {{ snipe_it_state }} + ansible.builtin.user: + name: "{{ snipe_it_user }}" + state: "{{ snipe_it_state }}" + system: "{{ snipe_it_user_system | default(true, true) }}" + create_home: "{{ snipe_it_user_create_home | default(false, true) }}" + groups: "{{ snipe_it_user_groups | default(omit, true) }}" + append: >-2 + {{ + snipe_it_user_groups_append | default( + snipe_it_user_groups | default([], true) | length > 0, + true, + ) + }} + register: snipe_it_user_info + +- name: Ensure snipe-it environment file is {{ snipe_it_state }} + ansible.builtin.file: + path: "{{ snipe_it_config_file }}" + state: "{{ snipe_it_state }}" + when: snipe_it_state == 'absent' + +- name: Ensure snipe-it config directory is {{ snipe_it_state }} + ansible.builtin.file: + path: "{{ snipe_it_config_file | dirname }}" + state: "{{ (snipe_it_state == 'present') | ternary('directory', 'absent') }}" + owner: "{{ snipe_it_run_user_id }}" + group: "{{ snipe_it_run_group_id }}" + mode: "0755" + when: snipe_it_state == 'present' + +- name: Ensure snipe-it data directory '{{ snipe_it_data_directory }}' is {{ snipe_it_state }} + ansible.builtin.file: + path: "{{ snipe_it_data_directory }}" + state: "{{ (snipe_it_state == 'present') | ternary('directory', 'absent') }}" + owner: "{{ snipe_it_run_user_id }}" + group: "{{ snipe_it_run_group_id }}" + mode: "0755" + +- name: Ensure snipe-it environment file is templated + ansible.builtin.copy: + content: |+2 + {% for entry in snipe_it_merged_config | dict2items %} + {{ entry.key }}={{ entry.value }} + {% endfor %} + path: "{{ snipe_it_config_file }}" + owner: "{{ snipe_it_run_user_id }}" + group: "{{ snipe_it_run_group_id }}" + mode: "0640" + when: snipe_it_state == 'present' + +- name: Deploy using {{ snipe_it_deployment_method }} + ansible.builtin.include_tasks: + file: "deploy-{{ snipe_it_deployment_method }}.yml" diff --git a/roles/snipe_it/vars/main.yml b/roles/snipe_it/vars/main.yml new file mode 100644 index 0000000..9111541 --- /dev/null +++ b/roles/snipe_it/vars/main.yml @@ -0,0 +1,6 @@ +--- +snipe_it_states: + - present + - absent +snipe_it_deployment_methods: + - docker