Github Actions와 Cloudtype을 활용한 CI/CD 자동 배포 설정

안녕하세요!

이번 게시글에서는 Cloudtype을 통한 Github Actions CI/CD 서비스 배포 방법을 공유하려 합니다.

우선, Cloudtype을 이용해 기본적인 배포를 완료한 상태라고 가정하고 진행합니다.

Cloudtype 배포를 진행하지 않은 분들은 아래 링크를 달아두었으니 이전 게시물을 참고해주세요.

 

2025.03.27 - [개인 프로젝트] - React + Spring 배포 (Cloudtype - 배포)

TalkHub - 1인 SNS 웹개발 프로젝트: 개발 과정 (Cloudtype - 배포)

---

📌  Github Actions란?

Github Actions는 Github에서 공식으로 제공하는 CI/CD(지속적 통합/지속적 배포) 자동화 도구입니다.
코드 푸시 또는 PR(풀 리퀘스트) 이벤트에 반응하여 빌드, 테스트, 배포 등의 작업을 자동으로 수행할 수 있게 해줍니다.

CI (Continuous Integration)

• 개발자가 변경한 코드를 푸시할 때마다 자동으로 빌드 및 테스트를 수행
• 코드 품질 및 동작을 빠르게 검증할 수 있음

CD (Continuous Deployment)

• 테스트를 통과한 코드가 자동으로 운영 환경에 배포
• 수동 배포보다 효율적이고, 실수를 줄일 수 있음

CI/CD의 장점

• 자동화된 배포로 실수 최소화
• 실시간 피드백 제공
• 효율적인 협업 환경 구축

 

---

 

📌  Cloudtype + Github Actions 연동

 

Cloudtype은 Github Actions 연동을 위한 가이드를 자체적으로 제공 하고 있으니 참고해주세요.

Cloudtype with Github Actions

 

---

 

1. Cloudtype에서 Github Actions 코드 복사

1) Cloudtype의 배포된 프로젝트 → CLI 탭으로 이동

 

2) 하단으로 스크롤하여 Github Actions 섹션 코드 복사

 

---

 

2. Github 리포지토리에 Workflow 파일 생성

1) 배포한 깃허브 리포지토리로 이동하여 새로운 파일을 생성해줍니다.

2) .github/workflows/deploy.yml 경로로 새 파일 생성

3) 1. Cloudtype에서 Github Actions 코드 복사 에서 복사한 코드를 해당 파일에 붙여넣어줍니다.

 

Cludtype에서 Build Variables를 지정했다면 buildenv 설정이 노출되어 있으니, 다음과 같이 수정하여 시크릿 변수를 사용해야 합니다:

buildenv:
                - name: REACT_APP_URL
                  value: ${{ secrets.REACT_APP_URL }}

 

---

 

3. Cloudtype에서 API 키 발급

1) Cloudtype 대시보드 → 설정 탭 → 인증 → API 키 생성

 

생성된 API키는 한 번만 확인 가능하니 복사 후 안전하게 보관

 

---

 

4. Github Personal Access Token 생성

1) Github 우측 상단 프로필 → Settings

2) 좌측 사이드바 최하단에 Developer settings탭 클릭

3) Personal access tokens  → Tokens (classic)

 

 

4) Generate new token을 클릭합니다.

 

5) token 생성

• Note: 자유롭게 지정
• Expiration: (예: 30일)
• Scopes: repo, admin:public_key 체크

생성된 token은 복사 후 안전하게 보관

 

---

 

5. Github Secrets 등록

1) Github 리포지토리 → Settings

2) 좌측 사이드 바에서 Secrets and variables → Actions로 이동합니다.

3) New repository secret 버튼을 클릭

Name	Secret 값
CLOUDTYPE_TOKEN	3. Cloudtype에서 API 키 발급에서 발급한 API 키
GHP_TOKEN	4. Github Personal Access Token 생성에서 생성한 Token 값

• Cludtype에서 Build Variables를 지정했다면 지정한 값들도 모두 마찬가지로 Secret 키로 생성해줍니다.

 

---

 

이상으로 Github Actions 설정을 모두 마쳤습니다. 이후 코드를 변경하고 Github에 푸시만 하면, Github Actions가 자동으로 실행되어 Cloudtype을 통해 배포까지 자동으로 완료됩니다.

자동화된 CI/CD 파이프라인을 통해 더욱 안정적이고 빠른 배포 환경을 구축할 수 있습니다.

이상으로 이번 포스팅을 마치겠습니다. 오늘도 행복한 하루 되세요!