ConoHa VPS に Docker Compose で Python API を構築する手順

ssh-keygen -t ed25519 -C "your_email@example.com"
# ~/.ssh/id_ed25519 と id_ed25519.pub が生成される
cat ~/.ssh/id_ed25519.pub
# 表示された公開鍵をコピーしてConoHaコンパネに登録する

ssh root@<サーバーのIPアドレス>

adduser deploy
# パスワードを設定する（強力なものを使うこと）
 
usermod -aG sudo deploy
 
# rootの公開鍵を新しいユーザーにもコピーする
mkdir -p /home/deploy/.ssh
cp ~/.ssh/authorized_keys /home/deploy/.ssh/
chown -R deploy:deploy /home/deploy/.ssh
chmod 700 /home/deploy/.ssh
chmod 600 /home/deploy/.ssh/authorized_keys

vim /etc/ssh/sshd_config

# rootログインを禁止
PermitRootLogin no
 
# パスワード認証を無効化（公開鍵のみ許可）
PasswordAuthentication no
 
# ポートをデフォルトから変更（任意だが推奨）
Port 2222

systemctl restart sshd

# SSHポート（変更した場合は2222）を先に許可してから有効化する
sudo ufw allow 2222/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
 
# ufwを有効化
sudo ufw enable
 
# 状態確認
sudo ufw status

sudo apt-get remove docker docker-engine docker.io containerd runc

# 必要パッケージをインストール
sudo apt-get update
sudo apt-get install -y ca-certificates curl gnupg
 
# Docker公式のGPGキーを追加
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | \
  sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg
 
# Dockerのaptリポジトリを追加
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] \
  https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
 
# Docker Engine + Compose プラグインをインストール
sudo apt-get update
sudo apt-get install -y \
  docker-ce \
  docker-ce-cli \
  containerd.io \
  docker-buildx-plugin \
  docker-compose-plugin

sudo usermod -aG docker $USER
 
# グループ変更を即時反映（またはいったんログアウトして再ログイン）
newgrp docker

docker --version
# Docker version 26.x.x, build ...
 
docker compose version
# Docker Compose version v2.x.x
 
# ハローワールドで動作確認
docker run hello-world

myapi/
├── docker-compose.yml
├── .env
├── nginx/
│   └── default.conf
└── app/
    ├── Dockerfile
    ├── requirements.txt
    └── main.py

fastapi==0.115.0
uvicorn[standard]==0.30.0

from fastapi import FastAPI
 
app = FastAPI()
 
@app.get("/")
def root():
    return {"status": "ok", "message": "API is running"}
 
@app.get("/health")
def health():
    return {"status": "healthy"}

FROM python:3.12-slim
 
WORKDIR /app
 
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
 
COPY . .
 
CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]

services:
  api:
    build: ./app
    container_name: myapi
    restart: always
    expose:
      - "8000"
    env_file:
      - .env
 
  nginx:
    image: nginx:alpine
    container_name: myapi_nginx
    restart: always
    ports:
      - "80:80"
    volumes:
      - ./nginx/default.conf:/etc/nginx/conf.d/default.conf
    depends_on:
      - api

# APIキーや設定値をここに書く
APP_ENV=production
LOG_LEVEL=info

.env

server {
    listen 80;
    server_name _;
 
    location / {
        proxy_pass http://api:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

# プロジェクトディレクトリに移動
cd ~/myapi
 
# バックグラウンドで起動
docker compose up -d
 
# ログ確認
docker compose logs -f
 
# 動作確認
curl http://localhost/
# {"status":"ok","message":"API is running"}

services:
  api:
    build: ./app
    container_name: myapi
    restart: always
    expose:
      - "8000"
    env_file:
      - .env
 
  nginx:
    image: nginx:alpine
    container_name: myapi_nginx
    restart: always
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./nginx/default.conf:/etc/nginx/conf.d/default.conf
      - ./certbot/conf:/etc/letsencrypt
      - ./certbot/www:/var/www/certbot
    depends_on:
      - api
 
  certbot:
    image: certbot/certbot
    volumes:
      - ./certbot/conf:/etc/letsencrypt
      - ./certbot/www:/var/www/certbot

server {
    listen 80;
    server_name example.com www.example.com;
 
    location /.well-known/acme-challenge/ {
        root /var/www/certbot;
    }
 
    location / {
        return 301 https://$host$request_uri;
    }
}
 
server {
    listen 443 ssl;
    server_name example.com www.example.com;
 
    ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
 
    location / {
        proxy_pass http://api:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

docker compose run --rm certbot certonly \
  --webroot \
  --webroot-path=/var/www/certbot \
  --email your@email.com \
  --agree-tos \
  --no-eff-email \
  -d example.com \
  -d www.example.com

# crontab -e で以下を追加
0 0 * * 0 cd ~/myapi && docker compose run --rm certbot renew && docker compose restart nginx

docker compose logs api
docker compose logs nginx

# コンテナのポートが正しく公開されているか確認
docker compose ps
 
# ホスト側でポートが使用中か確認
sudo ss -tlnp | grep :80

# コンテナのexit codeを確認
docker compose ps -a
 
# ログを追う
docker compose logs --tail=50 api

sudo systemctl enable docker
sudo systemctl start docker