ale을 로컬에 설치하고, 로컬 환경의 K8s 클러스터에 애플리케이션을 배포하는 가이드입니다.
ale
을 사용하기 위해서는 20 이상의 Node.js가 설치되어 있어야 합니다.Docker Desktop
Apply & restart
를 클릭하세요.OrbStack
Apply
를 클릭하세요.kind
다음의 명령어를 입력하여 ale-run 패키지를 설치합니다.
다음의 명령어를 입력하여 Nginx Ingress Controller를 설치하세요.
다음의 명령어를 입력하여 Metrics Server를 설치하세요.
다음의 명령어를 입력하여 ale을 개발 모드로 실행합니다.
ale을 사용하여 서비스를 배포할 클러스터를 선택합니다. 클러스터 목록은 `~/.kube/config` 에 등록된 컨텍스트를 통해 조회됩니다.
로컬 환경과 GitHub 연동하기
GitHub에 로그인 후, Settings > Developer Settings > GitHub Apps 페이지에서 New GitHub App을 클릭하면, GitHub App 생성 과정이 시작됩니다.1-1. 기본정보 입력
GitHub App을 생성하기 위한 정보를 아래와 같이 입력하세요.
http://localhost:9001
Add Callbak URL
로 항목 추가)
http://localhost:9009/oauth/github/callback
http://localhost:9009/oauth/github/connect/callback
ale
에 GitHub OAuth 등록시 사용됩니다.http
로 입력해야하며, localhost:9009
는 ale
의 API엔드포인트 주소입니다.Webhook 항목의 Active 체크를 해제하여 비활성화하세요.1-3. 권한 부여 및 APP 생성
Permission 항목에서 아래의 권한을 부여하고, Create GitHub App
버튼으로 APP을 생성하세요.
Repository permissions (9)
Organization permissions (2)
Account permissions (1)
ale
에 GitHub OAuth를 추가하기 위해 GitHub App Name 이외에 4개의 ID, Key 값이 필요합니다.
권한 부여 후 App이 생성되면, App ID 와 Client ID를 조회할 수 있습니다.2-2. Client Secret 조회
같은 화면에서 Generate a new client secret
을 클릭해 Client Secret을 생성하고 조회하세요.
2-3. Private Key 조회
화면 하단부의 Generate a private key
를 클릭하면 pem 파일이 다운로드 됩니다.
3. ale 운영시스템에 등록브라우저의 주소 창에http://localhost:9001
을 입력해 운영시스템에 접속한 후 설정 > 인증수단 > GitHub 드롭다운을 클릭한 후, 앞 단계에서 조회한 값들을 각 필드에 입력하고적용하기
를 클릭하세요.
브라우저의 주소 창에http://localhost:9001
를 입력하면ale
대시보드에 접속할 수 있습니다. 최초 접속 시, 기본 생성되는@dev
스페이스로 접속됩니다.
운영시스템 접속하기
대시보드 좌측 상단의 스페이스 이름을 클릭한 후 운영시스템을 선택하면 운영시스템에 접속할 수 있습니다.
대시보드의 또는 ⌘ + K
로 생성되는 배포창에서 HTTPBin을 선택하세요.
별도의 설정 변경 없이, 배포 설정 창 하단의 배포하기
를 클릭하세요.
서비스의 구동이 완료되면 이미지와 같이 실행 중으로 상태가 변경됩니다.
접속하기
를 클릭하면 구동된 서비스에 접속할 수 있습니다.