docs: rewrite README with structured overview and quick start guide
Replaces the minimal project description with a comprehensive README including a component overview table, quick start instructions, common Ansible operations, and links to detailed documentation. Aligns with Red Panda Approval™ standards.
This commit is contained in:
56
ansible/smtp4dev/deploy.yml
Normal file
56
ansible/smtp4dev/deploy.yml
Normal file
@@ -0,0 +1,56 @@
|
||||
---
|
||||
- name: Deploy smtp4dev with Docker Compose
|
||||
hosts: ubuntu
|
||||
become: true
|
||||
vars:
|
||||
required_service: smtp4dev
|
||||
tasks:
|
||||
- name: Check if host has smtp4dev service
|
||||
ansible.builtin.set_fact:
|
||||
has_smtp4dev_service: "{{required_service in services}}"
|
||||
|
||||
- name: Skip hosts without smtp4dev service
|
||||
ansible.builtin.meta: end_host
|
||||
when: not has_smtp4dev_service
|
||||
|
||||
- name: Create smtp4dev group
|
||||
ansible.builtin.group:
|
||||
name: "{{smtp4dev_group}}"
|
||||
|
||||
- name: Create smtp4dev user
|
||||
ansible.builtin.user:
|
||||
name: "{{smtp4dev_user}}"
|
||||
comment: "smtp4dev"
|
||||
group: "{{smtp4dev_group}}"
|
||||
system: true
|
||||
|
||||
- name: Add group smtp4dev to user ponos
|
||||
ansible.builtin.user:
|
||||
name: ponos
|
||||
groups: "{{smtp4dev_group}}"
|
||||
append: true
|
||||
|
||||
- name: Create smtp4dev directory
|
||||
ansible.builtin.file:
|
||||
path: "{{smtp4dev_directory}}"
|
||||
owner: "{{smtp4dev_user}}"
|
||||
group: "{{smtp4dev_group}}"
|
||||
state: directory
|
||||
mode: '750'
|
||||
|
||||
- name: Template docker-compose file
|
||||
ansible.builtin.template:
|
||||
src: docker-compose.yml.j2
|
||||
dest: "{{smtp4dev_directory}}/docker-compose.yml"
|
||||
owner: "{{smtp4dev_user}}"
|
||||
group: "{{smtp4dev_group}}"
|
||||
mode: '550'
|
||||
|
||||
- name: Reset SSH connection to apply group changes
|
||||
meta: reset_connection
|
||||
|
||||
- name: Start smtp4dev service
|
||||
community.docker.docker_compose_v2:
|
||||
project_src: "{{smtp4dev_directory}}"
|
||||
state: present
|
||||
pull: always
|
||||
24
ansible/smtp4dev/docker-compose.yml.j2
Normal file
24
ansible/smtp4dev/docker-compose.yml.j2
Normal file
@@ -0,0 +1,24 @@
|
||||
services:
|
||||
smtp4dev:
|
||||
image: rnwood/smtp4dev
|
||||
pull_policy: always
|
||||
container_name: smtp4dev
|
||||
restart: unless-stopped
|
||||
ports:
|
||||
- "{{smtp4dev_port}}:80"
|
||||
- "{{smtp4dev_smtp_port}}:25"
|
||||
- "{{smtp4dev_imap_port}}:143"
|
||||
volumes:
|
||||
- smtp4dev_data:/smtp4dev
|
||||
environment:
|
||||
ServerOptions__BasePath: "/"
|
||||
ServerOptions__Hostname: smtp4dev
|
||||
logging:
|
||||
driver: syslog
|
||||
options:
|
||||
syslog-address: "tcp://127.0.0.1:{{smtp4dev_syslog_port}}"
|
||||
syslog-format: "{{syslog_format}}"
|
||||
tag: "smtp4dev"
|
||||
|
||||
volumes:
|
||||
smtp4dev_data:
|
||||
Reference in New Issue
Block a user