เริ่มต้นใช้งาน

หากคุณใช้ macOS กับ Apple Silicon ข้ามหน้านี้แล้วใช้ตัวติดตั้งคำสั่งเดียว:

curl -fsSL https://f5-sales-demo.github.io/devcontainer/scripts/install.sh | bash

ตัวติดตั้งจะจัดการแพ็คเกจ Homebrew, การตั้งค่า iTerm2, การติดตั้ง Podman และดาวน์โหลดทุกอย่างที่คุณต้องการ

ข้อกำหนดเบื้องต้น

Container Runtime

คุณต้องมี container runtime บนเครื่องของคุณ Docker หรือ Podman สามารถใช้ได้ทั้งคู่

Docker
Podman

แพลตฟอร์ม	ติดตั้ง
macOS	Docker Desktop for Mac
Windows	Docker Desktop for Windows (WSL2 backend)
Linux	Docker Engine หรือ Docker Desktop for Linux

ตรวจสอบว่าทำงานได้:

docker --version
docker compose version

แพลตฟอร์ม	ติดตั้ง
macOS	Podman Desktop for Mac
Windows	Podman Desktop for Windows
Linux	Podman + Podman Compose

ตรวจสอบว่าทำงานได้:

podman --version
podman-compose version

Podman บน Linux รันคอนเทนเนอร์โดยตรง (ไม่ต้องใช้ VM) ตรวจสอบให้แน่ใจว่า Podman socket ทำงานอยู่เพื่อให้ podman-compose สามารถเชื่อมต่อได้:

systemctl --user enable --now podman.socket

ทรัพยากรระบบ

ทรัพยากร	ขั้นต่ำ	แนะนำ
ดิสก์	5 GB	10 GB+
RAM	8 GB จัดสรรให้ container runtime	12 GB+
CPU	2 คอร์	4+ คอร์

Docker
Podman

ปรับขีดจำกัดทรัพยากรใน Docker Desktop → Settings → Resources

บน macOS/Windows ปรับขีดจำกัดทรัพยากรใน Podman Desktop → Settings → Resources หรือผ่าน CLI:

podman machine set --cpus 4 --memory 12288
podman machine stop && podman machine start

บน Linux คอนเทนเนอร์ใช้ทรัพยากรของเครื่องโฮสต์โดยตรง — ไม่จำเป็นต้องตั้งค่าทรัพยากร

1. ตั้งค่า

สร้างโฟลเดอร์และดาวน์โหลดไฟล์ compose:

mkdir devcontainer && cd devcontainer
curl -fsSLO https://raw.githubusercontent.com/f5-sales-demo/devcontainer/main/docker-compose.yml

2. เพิ่มข้อมูลรับรองการยืนยันตัวตน (ไม่บังคับ)

สร้างไฟล์ .env ในโฟลเดอร์เดียวกันเพื่อตั้งค่า Claude Code ล่วงหน้า เลือกหนึ่งในตัวเลือกต่อไปนี้:

ตัวเลือก A: Claude Max (OAuth)

CLAUDE_CODE_OAUTH_TOKEN=sk-ant-oat01-your-token-here

ตัวเลือก B: LiteLLM หรือ Anthropic-compatible proxy

หากคุณมี LiteLLM instance หรือ Anthropic-compatible proxy อื่น ให้ตั้งค่าตัวแปรสองตัวนี้:

LITELLM_BASE_URL=https://your-litellm-endpoint.example.com
LITELLM_API_KEY=your-api-key

ตั้งค่าเฉพาะโดเมน — คอนเทนเนอร์จะสร้าง URL suffix เฉพาะผู้ให้บริการโดยอัตโนมัติ (เช่น /anthropic สำหรับ Claude Code)

ดึงค่าอัตโนมัติจากข้อมูลรับรองในเครื่อง

หากคุณมี git และ gh ตั้งค่าไว้บนเครื่องโฮสต์แล้ว คุณสามารถกรอกค่า .env ส่วนใหญ่ได้โดยอัตโนมัติ เริ่มจากคัดลอกเทมเพลต:

cp .env.example .env

จากนั้นรันคำสั่งที่ตรงกับการตั้งค่าของคุณ:

# Git identity
echo "GIT_AUTHOR_EMAIL=$(git config user.email)" >> .env
echo "GIT_AUTHOR_NAME=\"$(git config user.name)\"" >> .env

# Timezone
echo "TZ=$(readlink /etc/localtime | sed 's|.*/zoneinfo/||')" >> .env

# GitHub CLI token (requires: gh auth login)
echo "GH_TOKEN=$(gh auth token)" >> .env

# SSH key (if you use SSH for git)
echo "SSH_PRIVATE_KEY=$(base64 < ~/.ssh/id_ed25519)" >> .env

จากนั้นแก้ไข .env เพื่อเพิ่ม OAuth token หรือการตั้งค่า LiteLLM proxy (ดูตัวเลือกด้านบน)

docker compose up -d

podman-compose pull && podman-compose up -d

การรันครั้งแรกจะดึง image สำเร็จรูปจาก ghcr.io (~1 นาที ขึ้นอยู่กับการเชื่อมต่อของคุณ) การเริ่มต้นครั้งถัดไปจะใช้ image ที่แคชไว้และใช้เวลาเพียงไม่กี่วินาที

4. เชื่อมต่อ

Docker
Podman

docker compose exec dev zsh

podman-compose exec dev zsh

5. ตรวจสอบ

# AI tools
claude --version
codex --version
pi --version

# Languages
node --version
python3 --version
go version

# Cloud CLIs
aws --version
az --version
terraform --version

ทดสอบการเชื่อมต่อ AI:

claude -p "Say hello"

6. โปรเจกต์แรกของคุณ

cd /workspace
git clone https://github.com/your-org/your-project.git
cd your-project
claude

7. จอแสดงผลระยะไกล (noVNC)

คอนเทนเนอร์มีจอแสดงผลเสมือนสำหรับดู AI agent ควบคุมเบราว์เซอร์ เปิด http://localhost:6080/vnc.html เพื่อเชื่อมต่อ ดูรายละเอียดที่ จอแสดงผลระยะไกล (noVNC)

8. ระบบอัตโนมัติสำหรับเบราว์เซอร์ (Chrome DevTools MCP)

Claude Code สามารถเปิดหน้าเว็บ ถ่ายภาพหน้าจอ และตรวจสอบ DOM โดยใช้ Chrome DevTools MCP server ในตัว ไม่ต้องตั้งค่าใดๆ — ทำงานโดยอัตโนมัติในโหมด headless ดูรายละเอียดที่ Chrome DevTools MCP

9. หยุดและเริ่มใหม่

Docker
Podman

# หยุด (เก็บรักษาข้อมูล)
docker compose down

# เริ่มอีกครั้ง
docker compose up -d

# ลบทุกอย่างและเริ่มใหม่ตั้งแต่ต้น
docker compose down -v
docker compose up -d

# หยุด (เก็บรักษาข้อมูล)
podman-compose down

# เริ่มอีกครั้ง (pull เพื่อรับ image ล่าสุด)
podman-compose pull && podman-compose up -d

# ลบทุกอย่างและเริ่มใหม่ตั้งแต่ต้น
podman-compose down -v
podman-compose pull && podman-compose up -d

โค้ดของคุณใน /workspace และ home directory จะคงอยู่ข้ามการรีสตาร์ท ดูรายละเอียดที่ การตั้งค่า — การคงอยู่ของข้อมูล

สำหรับการ build ในเครื่องและการปรับแต่ง Dockerfile ดูที่ การพัฒนาในเครื่อง สำหรับการใช้งานร่วมกับ VS Code ดูที่ VS Code สำหรับตัวเลือกจอแสดงผลระยะไกล ดูที่ จอแสดงผลระยะไกล (noVNC)