Codeflow 문제 해결

본 문서는 Codeflow 서비스 사용 중 발생할 수 있는 문제를 해결하는 방법을 안내합니다.

워크플로우 파일이 목록에 표시되지 않음

워크플로우 파일이 콘솔의 워크플로우 목록에 표시되지 않을 수 있습니다.

워크플로우 파일은 기본 브랜치의 .codeflow/workflows 경로에 있어야 콘솔에서 인식됩니다.

▶️ 해결 방법: 워크플로우 YAML 파일을 기본 브랜치의 .codeflow/workflows 경로에 추가한 뒤 커밋 또는 머지하세요.

.codeflow/workflows/{워크플로우 파일명}.yml

워크플로우 실행 상태가 대기중에서 진행되지 않을 수 있습니다.

워크플로우를 처리할 러너가 실행 중이지 않거나, 워크플로우의 runs-on 값과 러너 라벨이 일치하지 않으면 워크플로우가 대기 상태에 머무를 수 있습니다.

▶️ 해결 방법: 액션 설정 > 러너에서 러너가 실행 가능한 상태인지 확인하고, 워크플로우의 runs-on 값이 러너 등록 시 지정한 --labels 값과 일치하는지 확인하세요.

러너 VM에서 Codeflow 또는 Container Registry에 접근하지 못할 수 있습니다.

러너 VM에 아웃바운드 인터넷 경로가 없으면 Codeflow 리포지토리나 Container Registry에 접근할 수 없습니다.

▶️ 해결 방법: 러너 VM이 외부로 통신할 수 있도록 퍼블릭 IP를 연결하거나 NAT를 구성하고, 보안 그룹의 아웃바운드 규칙을 확인하세요.

워크플로우의 이미지 빌드 단계가 실패할 수 있습니다.

이미지 빌드를 수행하는 러너 VM에 Docker가 설치되어 있지 않거나 Docker 데몬을 사용할 수 없으면 이미지 빌드 단계가 실패합니다.

▶️ 해결 방법: 러너 VM에 Docker를 설치하고 Docker 데몬이 실행 중인지 확인한 뒤 워크플로우를 다시 실행하세요.