Docker Inventory — prototype v0.1

Docker Inventory — prototype v0.1

Notes

Application web en lecture seule, destinée à cwwk (alder). Elle interroge les quatre Docker Engines par SSH et affiche conteneurs, projets Compose, montages et DockerRootDir.

Sécurité SSH — à préparer avant le démarrage

Les clés actuellement utilisées par sshm sont sur pc1 (/home/yann/.ssh). Elles ne sont pas disponibles automatiquement sur cwwk. Ne copie pas les clés privées existantes dans le conteneur.

Créer une clé dédiée sur cwwk, sous le compte qui administrera le projet :

1
2
3
4
sudo mkdir -p /opt/docker-inventory/ssh
sudo chown "$USER":"$USER" /opt/docker-inventory/ssh
chmod 700 /opt/docker-inventory/ssh
ssh-keygen -t ed25519 -N '' -f /opt/docker-inventory/ssh/id_ed25519 -C docker-inventory

Ajouter le contenu de id_ed25519.pub

echo “ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIKQYg10jCcrW7rhR8UjusvfSjI5U42yLvSJnOi8IW7o5 docker-inventory”  » ~/.ssh/authorized_keys

dans ~/.ssh/authorized_keys des comptes distants :

  • yick@192.168.0.205 port 55205
  • alpa@192.168.0.224 port 55224
  • rad@192.168.0.222 port 55222
  • alpi@192.168.0.223 port 55223

Le compte doit pouvoir exécuter docker sans interaction. Attention : l’appartenance au groupe docker donne pratiquement des privilèges root sur l’hôte. Il ne s’agit donc pas d’une véritable restriction de lecture seule au niveau système, même si l’application n’émet que des commandes de consultation.

Précharger les clés d’hôtes et vérifier leurs empreintes par un canal de confiance avant de les accepter :

1
2
3
4
5
6
touch /opt/docker-inventory/ssh/known_hosts
ssh-keyscan -p 55205 192.168.0.205 >> /opt/docker-inventory/ssh/known_hosts
ssh-keyscan -p 55224 192.168.0.224 >> /opt/docker-inventory/ssh/known_hosts
ssh-keyscan -p 55222 192.168.0.222 >> /opt/docker-inventory/ssh/known_hosts
ssh-keyscan -p 55223 192.168.0.223 >> /opt/docker-inventory/ssh/known_hosts
chmod 600 /opt/docker-inventory/ssh/id_ed25519 /opt/docker-inventory/ssh/known_hosts

Déploiement

Copier le projet dans /opt/docker-inventory, puis :

1
2
cd /opt/docker-inventory
docker compose up -d --build

Interface : http://192.168.0.205:8088

Proxy nginx

/etc/nginx/conf.d/docker.home.arpa.conf

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
server {
    # ipv4 listening port/protocol
    listen       443 ssl;
    # ipv6 listening port/protocol
    listen           [::]:443 ssl;
    allow 192.168.0.0/24;
    allow 100.64.0.0/10;
    allow fd7a:115c:a1e0::/48;
    allow 2a01:e0a:95a:e2f0::/64;
    deny all;
    http2 on;
    server_name  docker.home.arpa;

    ssl_certificate      /etc/ssl/homearpa/homearpa.crt;
    ssl_certificate_key  /etc/ssl/homearpa/homearpa.key;

    # connexion nginx fermée si sous domaine inexistant
    if ($http_host != "docker.home.arpa") {
     return 444;
    }

  location / { 
     proxy_pass              http://192.168.0.205:8088;
  } 

}

Lien: https://docker.home.arpa

Limites de cette première version

  • Aucun socket Docker n’est monté dans le conteneur.
  • Aucun redémarrage, déploiement, suppression ou changement de Stack n’est effectué.
  • Les Stacks sans conteneur ne peuvent pas être détectées par cette seule collecte ; une intégration API Portainer pourra compléter l’inventaire.
  • Les volumes Docker non utilisés et les données de la couche inscriptible seront ajoutés dans une version suivante.
  • Protéger l’accès web par authentification et HTTPS avant toute exposition hors LAN.