/start-11-1.en

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

🎓 Lesson 11-1: GitHub Actions Basics

📍 What You'll Do

**Lesson 11-1: Introduction to GitHub Actions**!

| Item | Details | |------|------| | Goal | Build CI/CD pipelines with GitHub Actions (automated testing and deployment) | | Duration | ~35 min | | Skills used | GitHub Actions, YAML workflows | | Prerequisites | GitHub repository, Lesson 0-1 (gh CLI) completion recommended | | Course page | [Module 11: GitHub Actions](https://ai-agent.camp/en/course/module-11) alongside this lesson |

**Session flow:** 1. Create the workflow directory 2. Hello World workflow 3. Python environment setup workflow 4. Scheduled execution workflow 5. Multi-job workflow

By the end of this session, tests and deployments will run automatically on push.

> **💡 Hint**: If the AI response stops midway, type "please continue" or "keep going" to resume. This is a Cursor behavior, not a malfunction.

---

🎯 Readiness Check

Let's first check that everything is ready.

**AskQuestion configuration:**

{
  "title": "🎯 Pre-session check",
  "questions": [{
    "id": "readiness",
    "prompt": "Are you ready?",
    "options": [
      {"id": "ready", "label": "Ready! Let's start"},
      {"id": "check_prereq", "label": "Check prerequisites"},
      {"id": "view_html", "label": "View the course page first"},
      {"id": "different_lesson", "label": "Go to a different lesson"}
    ]
  }]
}

(ready → Go to Step 1) (check_prereq → Run prerequisite verification) (view_html → Show course page path) (different_lesson → Display module list)

---

🚀 Step 1: Create Workflow Directory

Use AskQuestion to choose "Proceed / Just review the example / Skip".

**AskQuestion configuration:**

{
  "title": "🚀 Step 1: Create Workflow Directory",
  "questions": [{
    "id": "step_action",
    "prompt": "What would you like to do with this step?",
    "options": [
      {"id": "practice", "label": "Proceed"},
      {"id": "review", "label": "Just review the example"},
      {"id": "skip", "label": "Skip"}
    ]
  }]
}

**Guidance after selection:** Input:

Please create the GitHub Actions workflow directory in the ai-agent-camp project.

mkdir -p .github/workflows

Verify that the directory has been created.

**Expected result:** The `.github/workflows/` directory is created.

---

🚀 Step 2: Hello World Workflow

Use AskQuestion to choose "Proceed / Just review the example / Skip".

**AskQuestion configuration:**

{
  "title": "🚀 Step 2: Hello World Workflow",
  "questions": [{
    "id": "step_action",
    "prompt": "What would you like to do with this step?",
    "options": [
      {"id": "practice", "label": "Proceed"},
      {"id": "review", "label": "Just review the example"},
      {"id": "skip", "label": "Skip"}
    ]
  }]
}

**Guidance after selection:** Input:

Please create the .github/workflows/hello.yml file with the following content:

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 }}"

**Expected result:** A YAML file is created. It runs automatically when pushed to GitHub.

---

🚀 Step 3: Python Environment Setup Workflow

Use AskQuestion to choose "Proceed / Just review the example / Skip".

**AskQuestion configuration:**

{
  "title": "🚀 Step 3: Python Environment Setup Workflow",
  "questions": [{
    "id": "step_action",
    "prompt": "What would you like to do with this step?",
    "options": [
      {"id": "practice", "label": "Proceed"},
      {"id": "review", "label": "Just review the example"},
      {"id": "skip", "label": "Skip"}
    ]
  }]
}

**Guidance after selection:** Input:

Please create the .github/workflows/python-ci.yml file with the following content:

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

**Expected result:** A workflow for Python environment setup and test execution is created.

---

🚀 Step 4: Scheduled Execution Workflow

Use AskQuestion to choose "Proceed / Just review the example / Skip".

**AskQuestion configuration:**

{
  "title": "🚀 Step 4: Scheduled Execution Workflow",
  "questions": [{
    "id": "step_action",
    "prompt": "What would you like to do with this step?",
    "options": [
      {"id": "practice", "label": "Proceed"},
      {"id": "review", "label": "Just review the example"},
      {"id": "skip", "label": "Skip"}
    ]
  }]
}

**Guidance after selection:** Input:

Please create the .github/workflows/scheduled.yml file with the following content:

name: Scheduled Task

on:
  schedule:
    # Execute daily at 09:00 UTC (18:00 JST)
    - cron: '0 9 * * *'
  workflow_dispatch:
    inputs:
      task_name:
        description: 'Task name'
        required: true
        default: 'daily_check'
        type: choice
        options:
          - daily_check