ブログ完全自動化のインフラ：GitHub Actionsとコスト管理の極意

The Pain: CI/CDで「動かない」

ローカルで完璧に動くスクリプトも、クラウド（GitHub Actions）に上げると動かないことがあります。

• タイムゾーンの問題: 投稿日時がずれる。
• 環境変数の不備: APIキーが見つからない。
• 実行時間の超過: 無料枠（2000分/月）を使い切ってしまう。

The Solution: 賢いWorkflow設計

ブログ自動化において重要なのは「冪等性（何度実行しても同じ結果になること）」と「無駄の排除」です。

1. Cron Schedule: 定期実行のトリガー設定。
2. Environment Secrets: APIキーの安全な管理。
3. Cost Saving: 変更がないときは処理をスキップする。

The Implementation: Workflow定義

以下は、このブログを支える .github/workflows/auto-post.yml の構成例です。

name: Auto Post Article

on:
  schedule:
    # 毎日 日本時間の朝9時 (UTC 0:00)
    - cron: "0 0 * * *"
  workflow_dispatch: # 手動実行用

jobs:
  post-article:
    runs-on: ubuntu-latest
    timeout-minutes: 5 # 暴走防止

    env:
      TZ: "Asia/Tokyo" # タイムゾーン固定
      GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}
      NOTION_TOKEN: ${{ secrets.NOTION_TOKEN }}
      NOTION_DATABASE_ID: ${{ secrets.NOTION_DATABASE_ID }}

    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Setup pnpm
        uses: pnpm/action-setup@v4
        with:
          version: 9

      - name: Setup Node
        uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: "pnpm"

      - name: Install Dependencies
        run: pnpm install --frozen-lockfile

      - name: Generate & Post
        run: |
          # ドライランで記事生成
          CONTENT=$(node scripts/generate_gemini.mjs '{"keyword":"最新テック"}')

          # Notionへ投稿
          node scripts/post_notion.mjs "$CONTENT"

コスト管理のテクニック

GitHub Actionsの無料枠は月2000分です。毎日5分走らせても 5 * 30 = 150分 なので十分余裕がありますが、以下の工夫でさらに節約できます。

• timeout-minutes: 必ず設定しましょう。無限ループなどの事故で数百分を浪費するのを防ぎます。
• Cache: setup-node のキャッシュ機能を使い、npm install の時間を短縮します。
• Skip Logic: もし「今日は書くネタがない」とAPIが返した場合は、Notion投稿ステップを実行しないように if 条件をつけます。

The Takeaway: サーバーレスな執筆チーム

これで、以下のサイクルが完成しました。

1. Notion API (A-1): 落ちない投稿スクリプト
2. Robust Parser (A-2): 崩れない生成ロジック
3. GitHub Actions (A-3): 止まらない定期実行

サーバーを一切管理することなく、APIとGitHubだけで完結する「サーバーレスなAI執筆チーム」。これが個人開発におけるブログ運用の最適解の一つです。

次のシリーズでは、このAIチームの「知能」部分、つまりエージェントの制御手法（SDD）について深掘りします。

← Back to Series Hub