/start-11-1

description: "Lesson command"
chapter: "courses/aiagent/lesson03-core/module11-github-actions"
prerequisites: ["start-0-1"]
duration: "約35分"
level: "intermediate"
tags: ["github-actions", "ci-cd", "automation"]
nonInteractiveMode: deferred

🎓 Lesson 11-1: GitHub Actions Workflow基本・自動化

📍 このセッションでやること

**Lesson 11-1: GitHub Actions入門** へようこそ！

| 項目 | 内容 | |------|------| | ゴール | GitHub ActionsでCI/CDパイプラインを構築する（自動テスト・デプロイ） | | 所要時間 | 約35分 | | 使うスキル | GitHub Actions, YAML ワークフロー | | 前提条件 | GitHub リポジトリ、Lesson 0-1（gh CLI）完了推奨 | | 教材ページ | [Module 11: GitHub Actions](https://ai-agent.camp/ja/course/module-11) を並行参照 |

**このセッションの流れ:** 1. ワークフローディレクトリの作成 2. Hello Worldワークフロー 3. Python環境セットアップワークフロー 4. スケジュール実行ワークフロー 5. 複数ジョブのワークフロー

セッション終了時には、push時に自動でテストやデプロイが走るようになっています。

> **💡 ヒント**: AIの応答が途中で止まった場合は「続きを表示して」「止まってるよ」と入力すると再開します。これはCursorの仕様で、故障ではありません。

---

🎯 準備チェック

まずは準備が整っているか確認しましょう。

**AskQuestionの設定:**

{
  "title": "🎯 セッション開始前の確認",
  "questions": [{
    "id": "readiness",
    "prompt": "準備はできていますか？",
    "options": [
      {"id": "ready", "label": "準備OK！始めましょう"},
      {"id": "check_prereq", "label": "前提条件を確認したい"},
      {"id": "view_html", "label": "先に教材ページを見たい"},
      {"id": "different_lesson", "label": "別のレッスンに移動したい"}
    ]
  }]
}

(ready → Step 1へ) (check_prereq → 前提条件の確認を実行) (view_html → 教材ページのパスを案内) (different_lesson → モジュール一覧を表示)

---

🚀 Step 1: ワークフローディレクトリの作成

AskUserQuestion（AskQuestion）で「このまま進める / 例だけ確認 / スキップ」を選べます。

**AskQuestionの設定例:**

{
  "title": "🚀 Step 1: ワークフローディレクトリの作成",
  "questions": [{
    "id": "step_action",
    "prompt": "このステップをどうしますか？",
    "options": [
      {"id": "practice", "label": "このまま進める"},
      {"id": "review", "label": "例だけ確認する"},
      {"id": "skip", "label": "スキップする"}
    ]
  }]
}

**選択後の案内（例）**: 入力内容:

ai-agent-camp プロジェクトに GitHub Actions のワークフローディレクトリを作成してください。

mkdir -p .github/workflows

ディレクトリが作成されたことを確認してください。

**期待される結果**: `.github/workflows/` ディレクトリが作成されます。

---

🚀 Step 2: Hello Worldワークフロー

AskUserQuestion（AskQuestion）で「このまま進める / 例だけ確認 / スキップ」を選べます。

**AskQuestionの設定例:**

{
  "title": "🚀 Step 2: Hello Worldワークフロー",
  "questions": [{
    "id": "step_action",
    "prompt": "このステップをどうしますか？",
    "options": [
      {"id": "practice", "label": "このまま進める"},
      {"id": "review", "label": "例だけ確認する"},
      {"id": "skip", "label": "スキップする"}
    ]
  }]
}

**選択後の案内（例）**: 入力内容:

.github/workflows/hello.yml ファイルを作成し、以下の内容を記述してください：

name: Hello World

on:
  push:
    branches: [ main ]
  workflow_dispatch:

jobs:
  hello:
    runs-on: ubuntu-latest

    steps:
      - name: Say Hello
        run: echo "Hello, GitHub Actions!"

      - name: Print Date
        run: date

      - name: Print Environment
        run: |
          echo "GitHub Actor: ${{ github.actor }}"
          echo "GitHub Repository: ${{ github.repository }}"
          echo "GitHub Event: ${{ github.event_name }}"

**期待される結果**: YAMLファイルが作成されます。GitHubにプッシュすると自動実行されます。

---

🚀 Step 3: Python環境セットアップワークフロー

AskUserQuestion（AskQuestion）で「このまま進める / 例だけ確認 / スキップ」を選べます。

**AskQuestionの設定例:**

{
  "title": "🚀 Step 3: Python環境セットアップワークフロー",
  "questions": [{
    "id": "step_action",
    "prompt": "このステップをどうしますか？",
    "options": [
      {"id": "practice", "label": "このまま進める"},
      {"id": "review", "label": "例だけ確認する"},
      {"id": "skip", "label": "スキップする"}
    ]
  }]
}

**選択後の案内（例）**: 入力内容:

.github/workflows/python-ci.yml ファイルを作成し、以下の内容を記述してください：

name: Python CI

on:
  push:
    branches: [ main, develop ]
  pull_request:
    branches: [ main ]

jobs:
  test:
    runs-on: ubuntu-latest

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

      - name: Setup Python
        uses: actions/setup-python@v5
        with:
          python-version: '3.11'

      - name: Install dependencies
        run: |
          # uv は自動で最新のパッケージを管理します
          uv add pytest
          if [ -f pyproject.toml ]; then uv sync; fi

      - name: Run simple test
        run: |
          python -c "print('Python CI is working!')"
          python --version

**期待される結果**: Python環境のセットアップとテスト実行のワークフローが作成されます。

---

🚀 Step 4: スケジュール実行ワークフロー

AskUserQuestion（AskQuestion）で「このまま進める / 例だけ確認 / スキップ」を選べます。

**AskQuestionの設定例:**

{
  "title": "🚀 Step 4: スケジュール実行ワークフロー",
  "questions": [{
    "id": "step_action",
    "prompt": "このステップをどうしますか？",
    "options": [
      {"id": "practice", "label": "このまま進める"},
      {"id": "review", "label": "例だけ確認する"},
      {"id": "skip", "label": "スキップする"}
    ]
  }]
}

**選択後の案内（例）**: 入力内容:

.github/workflows/scheduled.yml ファイルを作成し、以下の内容を記述してください：

name: Scheduled Task

on:
  schedule:
    # 毎日 09:00 UTC（日本時間18:00）に実行
    - cron: '0 9 * * *'
  workflow_dispatch:
    inputs:
      task_name:
        description: 'タスク名'
        required: true
        default: 'daily_check'
        type: choice
        options:
          - daily_check
          - weekly_report

jobs:
  scheduled-task:
    runs-on: ubuntu-latest

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

      - name: Run scheduled task
        run: |
          echo "Running scheduled task at $(date)"
          echo "Task: ${{ github.event.inputs.task_name || 'daily_check' }}"

      - name: Check files
        run: |
          echo "Repository files:"
          ls -la

**期待される結果**: 定期実行と手動トリガー両方に対応したワークフローが作成されます。

---

🚀 Step 5: 複数ジョブのワークフロー

AskUserQuestion（AskQuestion）で「このまま進める / 例だけ確認 / スキップ」を選べます。

**AskQuestionの設定例:**

{
  "title": "🚀 Step 5: 複数ジョブのワークフロー",
  "questions": [{
    "id": "step_action",
    "prompt": "このステップをどうしますか？",
    "options": [
      {"id": "practice", "label": "このまま進める"},
      {"id": "review", "label": "例だけ確認する"},
      {"id": "skip", "label": "スキップする"}
    ]
  }]
}

**選択後の案内（例）**: 入力内容:

.github/workflows/multi-job.yml ファイルを作成し、以下の内容を記述してください：

name: Multi-Job Workflow

on:
  push:
    branches: [ main ]
  workflow_dispa