Skip to main content
ale 은 주요 CSP의 Kubernetes 클러스터 뿐만 아니라 Generic 형태의 클러스터 연결도 모두 지원합니다. 에이전트를 실행하는 방식에 따라 다음과 같이 클러스터를 추가로 등록하고 관리할 수 있습니다.

​
Node로 실행

AWS EC2에서 ale을 실행하는 경우 아래를 참고해 ale-run 패키지를 설치하기 전까지의 과정까지 진행하세요.
1

다음의 명령어를 입력하여 ale-run 패키지를 설치하세요.

mkdir ale-run
cd ale-run

npm i @ale-run/runtime@latest
2

다음의 명령어를 입력하여 ale 에이전트를 에이전트 모드로 실행합니다.

pm2 start "npx aled agent -c [Kubernetes 클러스터명]" --name "ale-agent" --watch
3

pm2에서 조회한 로그가 다음과 같이 표시되면 실행이 완료된 것입니다. 클러스터 등록에 필요한 에이전트 토큰 값은 `agent token is...`로 시작하는 로그에서 확인할 수 있습니다.

pm2 log ale-agent

...
0|ale-agent  | [INFO] [runtime:init] using embedded mongodb "mongodb://127.0.0.1:27017/ale" at "/home/ubuntu/.ale/mongodb"
0|ale-agent  | [INFO] [runtime:init] using cluster: default
0|ale-agent  | [INFO] [k8s] KubernetesClusterDriver initialized with agent {"connection":{"context":"default","namespace":"ale"},"stat":{"db":{"url":"mongodb://127.0.0.1:27017/","dbName":"ale"}}}
0|ale-agent  | [INFO] [k8s] ConfigContext initialized with {"connection":{"context":"default","namespace":"ale"},"stat":{"db":{"url":"mongodb://127.0.0.1:27017/","dbName":"ale"}}}
0|ale-agent  | [INFO] [k8s] connect k8s to "default"
0|ale-agent  | [INFO] [k8s] [agent] cluster agent initialized
0|ale-agent  | [INFO] [runtime:agent] Ale Agent is initialized with config
0|ale-agent  | [INFO] [agent-server] token loaded from secret "ale/agent-secrets"
0|ale-agent  | [INFO] [runtime:init] agent httpsd is listening at 0.0.0.0:9801
0|ale-agent  | [INFO] [runtime:init] agent token is cat-c5a7cea7b25709a0863ac64a80155d46.930d450e5893040b54820c83 
0|ale-agent  | [INFO] [k8s] config loaded from cluster from "ale/agent-config"
0|ale-agent  | [INFO] [stat] stat controller init {"collector":{"prefix":"ale"},"db":{"url":"mongodb://127.0.0.1:27017/","dbName":"ale"},"connection":{"context":"default","namespace":"ale"}}
0|ale-agent  | [INFO] [stat] connect k8s to "default"
0|ale-agent  | [INFO] [stat] stat watcher started
실행 중 데이터베이스 충돌이 발생하거나 설정을 초기화 하려는 경우, 다음의 명령을 입력하여 기존에 생성된 ale 데이터를 삭제 후 재실행하세요.
rm -r ~/.ale
4

운영시스템 설정페이지 하단부의 클러스터 연결하기를 클릭한 후, 아래의 값을 입력하세요.

  • 클러스터 플랫폼 : Generic Kubernetes
  • 이름, 표시명 : 대시보드에 표시될 이름
  • 에이전트 접속 주소
  • 토큰 : 전 과정에서 조회한 토큰값
연결된 클러스터는 대시보드에서 서비스 배포를 위한 프로젝트 또는 배포환경 생성 시, 서비스가 배포될 클러스터로 선택할 수 있습니다.

​
Kubernetes Pod로 실행

Kubernetes 클러스터에 ale을 설치하는 경우 다음의 페이지를 참고하여 진행하세요.
1

에이전트 외부 IP 조회

kubectl get svc \
    -n ale \
    ale-agent-lb \
    -o jsonpath='{.status.loadBalancer.ingress[0].hostname}' \
| xargs -I{} echo "https://{}"
2

에이전트 토큰값 조회

kubectl get secrets agent-secrets -n ale -o jsonpath='{.data.AGENT_TOKEN}' | base64 --decode
3

운영시스템 설정페이지 하단부의 클러스터 연결하기를 클릭한 후, 아래의 값을 입력하세요.

  • 클러스터 플랫폼 : 연결할 클러스터의 제공자 선택
  • 이름, 표시명 : 대시보드에 표시될 이름
  • 에이전트 접속 주소
  • 토큰 : 전 과정에서 조회한 토큰값
연결된 클러스터는 대시보드에서 서비스 배포를 위한 프로젝트 또는 배포환경 생성 시, 서비스가 배포될 클러스터로 선택할 수 있습니다.