💻 실무 DevOps 기초 루트 따라하기 — Docker, DockerHub, GitHub Actions, AWS EC2까지

chat gpt의 도움을 받으며 일단 배포 먼저 해보자!라는 생각으로 하나씩 해보고있다.

목표: Node.js + MongoDB 프로젝트를 GitHub Actions + DockerHub + Docker Compose + AWS EC2를 활용해 완전 자동화 + 실전 배포까지 해보기

github 레포지토리 2개에 push 되어있다.
devops-node-todo-api / compose-todo-api

devops-node-todo-api
compose-todo-api
코드를 깃허브에 올려뒀으니 참고해서 보면 좋을 것 같다.

전체 실습 흐름 요약

1. Node.js + MongoDB Todo API 만들기

• express와 mongoose로 간단한 /todos API 구현
• GET, POST, PUT, DELETE 라우트로 CRUD 구성
• MongoDB는 로컬이 아닌 도커 내부의 mongo 서비스로 연결

mongoose.connect('mongodb://mongo:27017/todos')

2. Docker로 백엔드 컨테이너화

• backend/Dockerfile 작성
• Node.js 앱을 도커 이미지로 빌드 가능하게 구성
  Dockerfile

FROM node:18
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
EXPOSE 3000
CMD ["node", "index.js"]

이후

 docker build -t devops-node-todo-api

를 이용해 도커 이미지를 빌드해주고

docker run -p 3000:3000 devops-node-todo-api

를 써서 도커 컨테이너를 실행해준다.
-p 3000:3000 -> 내 컴퓨터의 3000번 포트를 컨테이너 안의 3000번 포트와 연결

3. Docker Compose로 전체 서비스 관리

• docker-compose.yml로 백엔드 + MongoDB구성
  docker-compose.yml

services:
  backend:
    build: ./backend
    ports:
      - "3000:3000"
    depends_on:
      - mongo
  mongo:
    image: mongo
    ports:
      - "27017:27017"

• docker-compose up 으로 컨테이너 2개를 한번에 실행
  이때 중간에 gpt가 알려준 index.js 코드 중 일부를 일부러 안썼었다. 아예 안쓰는게 또 다른 문제기도 했던..

mongoose.connect('mongodb://mongo:27017/todos', {
  useNewUrlParser: true,
  useUnifiedTopology: true,
});

useNewUrlParser랑 useUnifiedTopology는 MongoDB 최신 버전에서는 필요없는 옵션.
그러나 mongoose.connect() 자체는 필수다. Node.js 서버가 MongoDB에 데이터를 저장/읽기 하려면 Mongoose가 MongoDB 서버와 "연결"되어 있어야하기 때문.

수정 코드

// MongoDB 연결
mongoose.connect('mongodb://mongo:27017/todos')
  .then(() => console.log('✅ MongoDB 연결 성공!'))
  .catch(err => console.error('❌ MongoDB 연결 실패:', err));

이후 docker-compose up --build를 다시 하고 localhost:3000/todos에 접속하니 [] 이 떴다(정상출력)

그다음 VS Code REST Client 확장으로 POST /todos 요청도 보내봤다.

• requests.http(REST Client가 읽을 요청 스크립트 파일)을 따로 만들어서 진행

여기에서의 문제는

PUT과 DELETE가 되지 않음
하나의 .http 파일에 GET, POST, PUT , DELETE등 여러 요청을 연습용으로 다 넣을 수 있다.
1. index.js에 PUT과 DELETE요청을 처리하는 코드를 넣지 않았기 때문이다.

그래서 index.js에 PUT, DELETE 코드를 추가했다.

// ✅ 할 일 수정 (PUT)
app.put('/todos/:id', async (req, res) => {
  const { id } = req.params;
  const updated = await Todo.findByIdAndUpdate(id, { text: req.body.text }, { new: true });
  if (updated) {
    res.json(updated);
  } else {
    res.status(404).json({ error: "할 일을 찾을 수 없어요!" });
  }
});

// ✅ 할 일 삭제 (DELETE)
app.delete('/todos/:id', async (req, res) => {
  const { id } = req.params;
  const deleted = await Todo.findByIdAndDelete(id);
  if (deleted) {
    res.json({ message: "삭제 완료!" });
  } else {
    res.status(404).json({ error: "삭제할 항목을 찾을 수 없어요!" });
  }
});

수정한 전체 .http 코드

### 전체 할 일 목록 조회
GET http://localhost:3000/todos
Accept: application/json

###

### 새로운 할 일 추가 (POST 요청)
POST http://localhost:3000/todos
Content-Type: application/json

{
  "text": "Docker Compose 실습 최고!"
}

###

### 할 일 수정 (PUT 요청)
PUT http://localhost:3000/todos/여기에_실제_ID_입력
Content-Type: application/json

{
  "text": "수정된 내용입니다!"
}

###

### 할 일 삭제 (DELETE 요청)
DELETE http://localhost:3000/todos/여기에_실제_ID_입력

2. requests.http에 실제ID를 틀리게 입력함
   너무 간단한 오류.. 당연히 ID가 맞아야 넣든 지우든 할것이다.

4. Github Actions + DockerHub 자동화 구축 (CI/CD)

• .github/workflows/docker.yml 작성
• GitHub에 push → Docker 이미지 자동 빌드 → DockerHub에 업로드
• GitHub Secrets에 DOCKER_USERNAME / DOCKER_PASSWORD 등록

yml 코드 중 일부

run: docker build -t ${{ secrets.DOCKER_USERNAME }}/compose-todo-api ./backend
run: docker push ${{ secrets.DOCKER_USERNAME }}/compose-todo-api

난 DockerHub 로그인에서 조금 막혔었다.
실수: GitHub Secrets에 DOCKER_NAME이라고 쓰고 yml엔 DOCKER_USERNAME이라고 쓰기(불일치)
여러번의 push 끝에 성공

여기까지하면

GitHub에 코드 푸시 → 자동으로 최신 Docker 이미지가 빌드됨
DockerHub에 latest 태그로 업로드됨
이제 누구나 docker pull로 받아서 실행 가능함!

이 가능하다

5. .env로 환경변수 분리 (.env 적용 실습)

• MongoDB 주소와 포트를 .env 파일로 분리
• process.env를 통해 코드에서 참조
  .env 코드

PORT=3000
MONGO_URL=mongodb://mongo:27017/todos

6. AWS EC2 서버에 배포

• EC2 Ubuntu 인스턴스 생성 & SSH 접속
• Docker + Docker Compose 설치
• GitHub에서 프로젝트 클론
• .env 작성 후 docker-compose up으로 컨테이너 실행
• 외부 IP + 3000 포트로 API 확인

EC2 인스턴스 만들기

1. https://aws.amazon.com 접속
2. EC2 > 인스턴스 시작
   운영체제: Ubuntu 22.04 LTS
   인스턴스 유형: t2.micro (프리 티어)
   키페어 생성 → .pem 파일 저장
   3.인스턴스 생성 후, 보안 그룹 설정에서 포트 열기
   22번: SSH
   3000번: Node.js 접속용 (커스텀 TCP)
   27017번: MongoDB 접속용 (선택)

chmod 400 이름.pem
ssh -i 이름.pem ubuntu@퍼블릭IP주소

wsl에서 EC2로 접속할때

이런 문구가 떠서 좀 당황했는데, 리눅스나 맥에나 SSH접근시 항상 물어보는 질문이라고 한다.

[Linux / Mac] SSH 접근시 "Are you sure you want to continue connecting (yes/no)?" 없이

이 링크를 참고하여 해결했다.

접속성공

그다음 다운받은 .pem 파일을 wsl로 옮겨줘야하는데,

explorer.exe .

이 명령어를 wsl에 입력해서 할 수 있었다. 신기하게 윈도우에 파일 복사하듯이 ctrl+c ctrl+v가 가능했다.

배포 완료

뭔가 이렇게 뜨더니

curl http://localhost:3000/todos

을 입력하니 [] 이 잘 나왔다.

소감:
이번 실습을 통해 단순한 API 서버를 넘어서 도커화 → 자동화 → 배포까지 한 번에 경험할 수 있어 좋았다. 아직도 잘 모르겠지만 계속 하다보면 조금이라도 알게되지 않을까.