AI로 이 사이트를
어떻게 만들었을까요?

준비물과 바꿔 넣을 이름

이 프로젝트는 GitHub 저장소 cel0843/groupWebTest, 서울 AWS 리전 ap-northeast-2, 운영 도메인 ckddms.com을 사용합니다. 그대로 따라 만드는 사람은 자신의 저장소·도메인·AWS 계정 값으로 바꿔야 합니다.

현재 원본 GitHub 저장소는 비공개라 외부인이 코드를 그대로 복제할 수는 없습니다. 먼저 자신의 Node.js 앱 코드를 저장소에 준비한 뒤, 이 글의 서버·CI/CD·AI 연결 절차를 적용하면 같은 방식으로 운영할 수 있습니다.

서버, 데이터베이스, 파일 보관소 만들기

EC2는 사이트 프로그램이 실행되는 컴퓨터, RDS PostgreSQL은 게시글·사용자·개발 요청을 저장하는 데이터베이스입니다. S3는 첨부파일을 보관할 때 선택할 수 있습니다. 이 사이트의 앱 코드는 Node.js 22, Express, EJS, PostgreSQL로 구성되어 있습니다.

EC2에 Node.js 앱을 준비하기

AWS 콘솔의 EC2 Instance Connect 또는 Systems Manager Session Manager로 접속한 뒤, 아래 명령을 EC2의 ec2-user 터미널에서 실행합니다. 이 프로젝트의 CI와 서버는 Node.js 22를 기준으로 합니다.

sudo dnf install -y git nginx nodejs22 nodejs22-npm
node --version
npm --version
sudo systemctl enable --now nginx

node --version에 22가 나오지 않으면 설치된 Node 버전의 선택 상태를 확인합니다. 앱은 현재 /home/ec2-user/groupware에 놓여 있습니다. GitHub에서 코드를 가져오는 명령은 다음 장의 읽기 키 등록을 마친 뒤 실행합니다.

운영 설정 파일은 서버에만 둡니다

코드를 받은 뒤 저장소의 .env.example을 복사하고 .env를 수정합니다. DATABASE_URL은 RDS 연결 주소이고 SESSION_SECRET은 로그인 세션을 지키는 긴 임의 문자열입니다. 실제 값은 이 글, GitHub 코드, GitHub Variables에 입력하지 않습니다.

cd /home/ec2-user/groupware
umask 077
cp .env.example .env
nano .env
chmod 600 .env

DATABASE_URL=postgresql://YOUR_DB_USER:YOUR_DB_PASSWORD@YOUR_RDS_ENDPOINT:5432/groupware
NODE_ENV=production
PORT=3000
SESSION_SECRET=YOUR_LONG_RANDOM_SECRET
ALLOW_PUBLIC_REGISTRATION=false
STORAGE_DRIVER=local

이 앱은 시작할 때 필요한 테이블을 준비하고 /health에서 DB 연결까지 확인합니다. 기존 데이터를 지우는 명령은 일반 배포에 포함하지 않습니다.

서버가 재시작해도 앱을 켜 두기

이 사이트의 배포 스크립트는 groupware라는 systemd 서비스를 다시 시작합니다. 새로 만드는 서버라면 아래처럼 서비스를 등록합니다. command -v node 결과가 /usr/bin/node와 다르면 ExecStart 경로를 바꿉니다.

command -v node
sudo nano /etc/systemd/system/groupware.service

[Unit]
Description=GW System groupware
After=network-online.target

[Service]
Type=simple
User=ec2-user
WorkingDirectory=/home/ec2-user/groupware
ExecStart=/usr/bin/node app.js
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

cd /home/ec2-user/groupware
npm ci --omit=dev
sudo systemctl daemon-reload
sudo systemctl enable --now groupware
sudo systemctl status groupware --no-pager
curl http://127.0.0.1:3000/health

EC2가 GitHub 코드를 읽도록 하기

운영 서버는 저장소의 최신 코드를 읽어야 합니다. 실제로 이 프로젝트에서는 EC2에서 SSH 공개 키와 개인 키를 만들고, 공개 키만 GitHub 저장소의 Settings → Deploy keys에 등록했습니다. 읽기 전용으로 두었으므로 서버가 저장소 코드를 수정하지는 못합니다.

mkdir -p ~/.ssh && chmod 700 ~/.ssh
ssh-keygen -t ed25519 -C "groupware-production-deploy" -f ~/.ssh/groupware_deploy -N ""
cat ~/.ssh/groupware_deploy.pub

마지막 명령의 ssh-ed25519로 시작하는 한 줄만 GitHub의 Settings → Deploy keys → Add deploy key에 넣습니다. Allow write access는 선택하지 않습니다. 확장자가 .pub이 아닌 ~/.ssh/groupware_deploy 파일은 서버 밖으로 복사하지 않습니다.

cat > ~/.ssh/config <<'EOF'
Host github.com
  HostName github.com
  User git
  IdentityFile ~/.ssh/groupware_deploy
  IdentitiesOnly yes
  StrictHostKeyChecking accept-new
EOF
chmod 600 ~/.ssh/config

# 처음 설치라면 자신의 저장소 주소로 복제
git clone git@github.com:YOUR_OWNER/YOUR_REPO.git /home/ec2-user/groupware

# 이미 복제한 이 프로젝트에서는 원격 주소를 SSH로 변경
cd /home/ec2-user/groupware
git remote set-url origin git@github.com:cel0843/groupWebTest.git
git fetch origin main
git status --short --branch
git remote get-url origin

도메인과 HTTPS로 앱을 보여주기

도메인의 DNS에서 YOUR_DOMAIN을 EC2의 고정 공인 주소로 연결합니다. Nginx는 인터넷의 80/443 요청을 받고, 같은 서버의 Node.js 127.0.0.1:3000으로 전달합니다. 이 프로젝트에서는 ckddms.com이 실제 운영 주소입니다.

sudo nano /etc/nginx/conf.d/groupware.conf

server {
    listen 80;
    server_name YOUR_DOMAIN;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

sudo nginx -t
sudo systemctl reload nginx
sudo dnf install -y certbot python3-certbot-nginx
sudo certbot --nginx -d YOUR_DOMAIN
curl -I https://YOUR_DOMAIN/login

HTTPS 인증서는 자신이 관리하는 도메인으로 발급합니다. 발급 전에 DNS가 EC2를 가리키고 80 포트가 연결되는지 확인합니다. 이 앱은 운영 환경에서 HTTPS 뒤의 프록시를 신뢰하고 로그인 쿠키를 안전하게 설정합니다.

GitHub가 코드를 먼저 검사합니다

CI는 “코드를 합치기 전에 자동으로 점검한다”는 뜻입니다. 이 저장소의 .github/workflows/ci-cd.yml은 main으로 향하는 Pull Request와 main의 변경을 만나면 실행됩니다.

로컬에서도 같은 검사를 실행할 수 있습니다. GitHub 저장소의 Actions → CI and production deploy에서 각 단계가 성공했는지 확인합니다. main 보호 규칙을 사용할 수 있는 계정이라면 PR과 Test 통과를 병합 조건으로 설정합니다.

git switch -c feat/my-feature
# 코드 수정 후
git add .
git commit -m "feat: add my feature"
git push -u origin feat/my-feature

GitHub에서 이 브랜치의 Pull Request를 만들고 검사 결과를 봅니다. 기능을 사람이 직접 개발할 때는 검토 후 병합하고, 아래의 AI 개발 요청 경로는 현재 워크플로가 자동 검사 뒤 PR을 자동 병합합니다.

GitHub Actions가 AWS EC2에 배포합니다

CD는 검사를 통과해 main에 들어온 코드를 운영 서버에 반영하는 단계입니다. GitHub는 고정 AWS Access Key를 저장하지 않고 OIDC로 AWS에서 잠깐 유효한 권한을 받습니다. AWS IAM의 신뢰 정책은 어떤 저장소와 브랜치가 이 역할을 맡을지 정합니다.

{
  "Version": "2012-10-17",
  "Statement": [{
    "Effect": "Allow",
    "Principal": {
      "Federated": "arn:aws:iam::YOUR_ACCOUNT_ID:oidc-provider/token.actions.githubusercontent.com"
    },
    "Action": "sts:AssumeRoleWithWebIdentity",
    "Condition": {
      "StringEquals": {
        "token.actions.githubusercontent.com:aud": "sts.amazonaws.com",
        "token.actions.githubusercontent.com:sub": "repo:YOUR_OWNER/YOUR_REPO:ref:refs/heads/main"
      }
    }
  }]
}

GitHub 저장소의 생성 시점 또는 설정에 따라 sub에 owner/repository ID가 들어가는 형식이 쓰일 수 있습니다. IAM 신뢰 정책을 저장하기 전에 GitHub의 OIDC subject 문서에서 자신의 저장소 형식을 확인하세요.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "ssm:SendCommand",
      "Resource": [
        "arn:aws:ec2:ap-northeast-2:YOUR_ACCOUNT_ID:instance/YOUR_INSTANCE_ID",
        "arn:aws:ssm:ap-northeast-2::document/AWS-RunShellScript"
      ]
    },
    {
      "Effect": "Allow",
      "Action": "ssm:GetCommandInvocation",
      "Resource": "*"
    }
  ]
}

git checkout -B main TARGET_COMMIT_SHA
npm ci --omit=dev
npm run check
npm test
sudo systemctl restart groupware
curl http://127.0.0.1:3000/health

스크립트는 Git 커밋 SHA가 올바른지와 서버의 추적 파일에 직접 수정한 내용이 없는지 먼저 검사합니다. /health는 앱과 DB가 정상인지 확인합니다. 이 확인이 실패하면 스크립트가 직전 커밋으로 코드와 패키지를 되돌리고 서비스를 다시 시작합니다. DB와 업로드 파일을 삭제하지 않습니다.

10달러로 AI 기능을 시험하고 서버에 키 연결하기

이 프로젝트에서는 사용자가 OpenAI Platform에 10달러 크레딧을 충전한 뒤 API 키를 발급했습니다. 화면에서 자동 충전은 꺼진 상태를 확인했습니다. 충전액은 이 사이트를 만들기 위해 실제로 선택한 금액이지, 다른 사람의 필수 결제액은 아닙니다. OpenAI API 청구와 AWS 서버 청구는 별개입니다.

OPENAI_API_KEY=YOUR_OPENAI_KEY
OPENAI_MODEL=gpt-5-mini
OPENAI_CODING_MODEL=gpt-5-mini

cd /home/ec2-user/groupware
chmod 600 .env
node -e "require('dotenv').config(); console.log(process.env.OPENAI_API_KEY ? 'configured' : 'missing')"
sudo systemctl restart groupware
sudo systemctl status groupware --no-pager

configured는 서버가 환경변수를 읽었다는 뜻입니다. 실제 API 호출은 관리자 계정으로 그룹웨어의 개발 요청을 열고 AI 요구사항 분석을 실행해 확인합니다. 이때 키가 유효하고 계정에 사용 가능한 한도가 있어야 분석 결과가 나옵니다. 이 사이트의 코드는 공식 Node.js SDK의 responses.create()를 사용합니다.

요청 한 줄이 코드·Pull Request·배포로 이어지는 법

OpenAI 키를 연결하면 먼저 요구사항 분석을 할 수 있습니다. 자동 코드 개발까지 하려면 서버가 GitHub Actions를 시작할 권한과, GitHub Actions가 서버의 자동화 API를 부를 공유 토큰도 필요합니다.

GitHub 계정의 Settings → Developer settings → Personal access tokens에서 이 저장소에 제한된 fine-grained 토큰을 만들고 Actions 워크플로 실행 권한을 부여해 서버의 GITHUB_ACTIONS_TOKEN으로 저장합니다. 이 프로젝트에서도 초기에 쓰던 불필요한 복제용 PAT는 폐기하고, 서버 코드 읽기는 앞 장의 Deploy key로 바꿨습니다.

GitHub 저장소의 Settings → Secrets and variables → Actions → Secrets에는 AI_AUTOMATION_TOKEN을 넣습니다. EC2의 같은 이름 환경변수와 동일한 값이어야 합니다. 값은 비밀번호 관리자에서 만들거나 아래 명령으로 새 임의 문자열을 만든 뒤 안전하게 보관합니다.

openssl rand -hex 32

GitHub 저장소의 Settings → Actions → General에서는 워크플로가 필요한 쓰기 권한과 Pull Request 생성 권한을 사용할 수 있게 설정합니다. .github/workflows/ai-development.yml에는 actions: write, contents: write, pull-requests: write가 선언되어 있습니다.

기능 하나를 바꿀 때 무엇을 누르고 볼까요?

AI가 만든 코드도 항상 원하는 동작을 보장하지 않습니다. 사이트에서 실제로 확인하고, 결과가 요구사항과 다르면 새 요청이나 수정 요청으로 보완합니다.

어디가 멈췄는지 순서대로 찾기

오류 화면이나 로그를 공유하기 전에 API 키, DB 암호, 세션 비밀값이 들어 있지 않은지 확인합니다. 값이 공개됐다면 키를 폐기하고 새로 발급합니다.

같은 사이트를 만들었다면 여기까지 보여야 합니다

• EC2에서 systemctl status groupware가 실행 중으로 나옵니다.
• https://YOUR_DOMAIN/health가 {"status":"ok"}를 반환합니다.
• Pull Request의 GitHub Actions Test가 통과합니다.
• main 병합 뒤 Deploy to EC2가 통과합니다.
• AI 분석 결과가 나오고, 승인한 요청의 진행 단계가 업데이트됩니다.
• 배포 완료 후 사이트 화면에서 새 기능이 실제로 동작합니다.