Design Doc: compose-cd

背景

• CI/CD(Continuous Integration/Deployment)は最高
  • ここでの雰囲気は以下
  • CI: 全部Git管理してcommit毎に色々検証
    • これでPull Request上でマズいものはチェックする
  • CD: HEADのものを自動でどーんとデプロイ
  • k8s+ArgoCDによる最高の体験
• docker-compose でもContinuous Deploymentしたい！
  • k8s+ArgoCDは素晴らしいが，環境構築もメンテもダルい
  • コストに見合わない単純な(docker-composeで十分な)やつでもどうにかならんか
• 開発場所とデプロイ先を分けたい
  • デプロイ先で docker-compose build とかやりたくない
  • → イメージは(ちゃんとビルド・プッシュして)コンテナレジストリから
  • → 設定ファイル群はGit管理
  • git pull と docker-compose up -dだけでデプロイしたい(するようにしている)

課題

• docker-compose で立てたサービスの更新がダルい
  • イメージの更新がダルい
    • 例: :latest
    • :v1.0 とかでも実際のイメージ(digest)は裏でどんどん更新されていくことは多い
    • 新しいものがあるなら更新したい(逆に，真にイメージを固定したいならdigest pinningするべき)
  • 設定とかも更新したい
    • git pull して docker-compose down/up -d するだけではある
    • めんどい

概要

• 定期的に以下を実行するスクリプト
  • git pull
  • docker-compose pull
  • docker-compose down
  • docker-compose up -d

実装

compose-cd(本体)

• Shell script(Bash)
  • 移植性を考えるとBashはやや微妙だが，docker-composeを使うような環境では問題ないだろう
• 定期実行部以外のすべての実装はこのファイル1つに集約(ポン置きで動く)
• 設定ファイルは /etc/compose-cd/config (compose-cd install時に生成)
  • グローバルな設定を HOGE=value の形でしておき，実態としては source するだけ
  • DISCORD_WEBHOOK:

定期実行部分

• compose-cd update を定期的に実行する
• systemd timerで実装
• 定期実行以外に要求は無いので実際はcronでも雑なスクリプトでのループでもよい