almaops.ct_redis

Rôle Ansible : Conteneur Redis

Ce rôle crée un conteneur Redis sur l'hôte cible.

Exigences

L'hôte cible doit avoir le moteur Docker en cours d'exécution et avoir installé le module PIP Docker.

Variables du rôle

Veuillez vous référer à defaults/main.yml pour la liste complète des variables disponibles.

Paramètres réseau

Variable	Par défaut	Description
`ct_redis_enable_ports`	`true`	Drapeau qui contrôle si le port Redis par défaut est proxifié
`ct_redis_bind_addr`	`"127.0.0.1"`	Adresse IP à laquelle le conteneur Redis est lié
`ct_redis_bind_port`	`"6379"`	Port auquel le conteneur Redis est lié
`ct_redis_bind_ct_port`	`"6379"`	Port auquel le serveur Redis est lié
`ct_redis_ct_ports_default`	`[]`	Port Redis par défaut proxifié au conteneur Si `{{ ct_redis_enable_ports }}` est `false`, cette liste est vide Si `true`, la liste est définie sur `["{{ ct_redis_bind_addr }}:{{ ct_redis_bind_port }}:{{ ct_redis_bind_ct_port }}"]`
`ct_redis_ct_ports_extra`	`[]`	Ports arbitraires définis par l'utilisateur proxifiés au conteneur
`ct_redis_ct_ports`	`{{ ct_redis_ct_ports_default + ct_redis_ct_ports_extra }}`	Ensemble résultant de ports proxifiés au conteneur Passé au paramètre `ports` du module `docker_container`

Paramètres de volume

Variable	Par défaut	Description
`ct_redis_path_config_base`	`/etc/ct_redis`	Répertoire où les fichiers de configuration personnalisés sont placés
`ct_redis_path_config_file`	`{{ ct_redis_path_config_base }}/{{ ct_redis_ct_name }}.conf`	Nom du fichier de configuration, par défaut au nom du conteneur
`ct_redis_path_ct_config_file`	`/usr/local/etc/redis/redis.conf`	Chemin vers la configuration personnalisée à l'intérieur du conteneur
`ct_redis_path_data_base`	`/srv/ct_redis`	Répertoire de base pour les volumes de données
`ct_redis_path_data_volume`	`{{ ct_redis_path_data_base }}/{{ ct_redis_ct_name }}`	Répertoire de données monté dans le conteneur
`ct_redis_path_ct_data`	`/data`	Répertoire de données à l'intérieur du conteneur
`ct_redis_ct_volumes_data`	`["{{ ct_redis_path_data_volume }}:{{ ct_redis_path_ct_data }}"]`	Montage du répertoire de données
`ct_redis_ct_volumes_config`	`[]`	Montage de configuration personnalisée, Si `{{ ct_redis_enable_custom_config }}` est `true`, la valeur est définie sur `["{{ ct_redis_path_config_file }}:{{ ct_redis_path_ct_config_file }}:ro"]`
`ct_redis_ct_volumes_extra`	`[]`	Montages arbitraires définis par l'utilisateur au conteneur, au format `["/source:/dest"]`
`ct_redis_ct_volumes`	`{{ ct_redis_ct_volumes_data + ct_redis_ct_volumes_config + ct_redis_ct_volumes_extra }}`	Ensemble résultant de montages, passé au paramètre `volumes` du module `docker_container`

Configuration personnalisée

Le rôle fournit un simple drapeau pour activer un fichier de configuration personnalisé pour le conteneur Redis.

Variable	Par défaut	Description
`ct_redis_enable_custom_config`	`false`	Drapeau qui contrôle le montage du fichier de configuration personnalisé dans le conteneur Si la valeur est définie sur `true`, les variables `{{ ct_redis_ct_volumes_config }}` et `{{ ct_redis_ct_command_custom_config }}` sont remplacées par celles de vars, une fois le drapeau activé, le fichier de configuration Redis est créé à partir du modèle sur l'hôte cible et monté dans le conteneur, le chemin vers le fichier de configuration est ajouté à la `CMD` du conteneur
`ct_redis_cfg_extra`	`{}`	Paires clé-valeur des paramètres de configuration Redis pour le modèle de configuration personnalisé par défaut

Commande

Variable	Par défaut	Description
`ct_redis_ct_command_custom_config`	`[]`	Chemin vers le fichier de configuration personnalisé à l'intérieur du conteneur, qui est ajouté à la `CMD` du conteneur, Si `{{ ct_redis_enable_custom_config }}` est vrai, la valeur est définie sur `["{{ ct_redis_path_ct_config_file }}"]`
`ct_redis_ct_command_options`	`[]`	Options arbitraires définies par l'utilisateur passées à l'exécutable `redis-server`
`ct_redis_ct_command`	`{{ [\"redis-server\"] + ct_redis_ct_command_custom_config + ct_redis_ct_command_options }}`	Commande résultante passée au conteneur comme paramètre `command` du volume `docker_container`

Dépendances

Aucune.

Exemple de playbook

# Crée un conteneur Redis lié à une adresse IP et un port personnalisés
- hosts:
    - redis_server
  become: true
  roles:
    - role: almaops.ct_redis
      ct_redis_bind_addr: "192.168.0.10"
      ct_redis_bind_port: "26379"

# Crée un conteneur Redis avec une configuration personnalisée à partir de votre propre modèle redis.conf
- hosts:
    - redis_server
  become: true
  roles:
    - role: almaops.ct_redis
      ct_redis_enable_custom_config: true
      ct_redis_template_config: "/path/to/custom/redis.conf.j2"