콘텐츠로 이동

Launcher 서비스 설치 구성

제품 소개

Guance을 배포 및 설치하는 WEB 애플리케이션으로, Launcher 서비스의 안내 단계에 따라 Guance의 설치와 업그레이드를 완료합니다.

키워드

용어 설명
Launcher Guance을 배포 및 설치하는 WEB 애플리케이션으로, Launcher 서비스의 안내 단계에 따라 Guance의 설치와 업그레이드를 완료합니다.
운영 작업 머신 kubectl이 설치되어 있으며 대상 Kubernetes 클러스터와 동일한 네트워크에 있는 운영 머신입니다.
설치 작업 머신 브라우저에서 launcher 서비스에 접속하여 Guance 안내 설치를 완료하는 머신입니다.
hosts 파일 hosts 파일은 확장자가 없는 시스템 파일입니다. 주요 역할은 도메인과 IP의 매핑 관계를 저장하는 것입니다.

사전 요구 사항

인프라 배포가 완료되어 있어야 합니다.

1. Launcher 설치

주의

Launcher를 배포할 때 rbac 권한이 cluster-admin인지 확인하세요. 그렇지 않으면 Launcher 배포 시 오류가 발생합니다. 오프라인 네트워크 환경인 경우 Guance 오프라인 패키지 다운로드 및 가져오기를 참조하여 배포할 수 있습니다. GuanceDB 엔진은 GuanceDB 2.0 또는 GuanceDB 3.0, 그리고 GuanceDB for Mertics에 대한 동시 쓰기를 지원합니다.

  • 설치
helm install launcher launcher  --repo https://pubrepo.guance.com/chartrepo/launcher -n launcher \
  --create-namespace  \
  --set ingress.hostName=<Hostname>,storageClassName=<Stroageclass>
주의

<Hostname>은 Launcher ingress 도메인이며, <Stroageclass>는 스토리지 클래스 이름으로 kubectl get sc를 실행하여 확인할 수 있습니다.

helm install launcher launcher  --repo https://pubrepo.guance.com/chartrepo/launcher -n launcher \
   --create-namespace  \
   --set ingress.hostName="poc-launcher.dataflux.cn",storageClassName=df-nfs-storage        
  • Launcher 제거
helm uninstall launcher -n launcher
주의

Launcher 설치가 완료된 후에는 정상적인 상황이 아니면 제거하지 마세요.

  • YAML 설치

Launcher YAML 다운로드: https://static.guance.com/launcher/launcher.yaml

위 YAML 내용을 launcher.yaml 파일로 저장하여 운영 작업 머신에 배치한 후, 문서 내 변수 부분을 교체합니다:

  • {{ launcher_image }}을 최신 버전의 Launcher 애플리케이션 이미지 주소로 교체합니다. 최신 버전의 Launcher 설치 이미지 주소는 배포 이미지 문서에서 확인할 수 있습니다.
  • {{ domain }}을 기본 도메인으로 교체합니다(예: dataflux.cn 사용).
  • {{ storageClassName }}을 스토리지 클래스 이름으로 교체합니다(예: alicloud-nas).

기본 storageclass가 구성된 리소스에는 default가 표시됩니다. 아래 그림을 참조하세요.

운영 작업 머신에서 다음 kubectl 명령을 실행하여 Launcher 서비스를 가져옵니다:

kubectl apply -f ./launcher.yaml

  • YAML 제거
kubectl delete -f ./launcher.yaml
주의

Launcher 설치가 완료된 후에는 정상적인 상황이 아니면 제거하지 마세요.

2. launcher 도메인을 launcher 서비스에 연결

launcher 서비스는 Guance의 배포 및 업그레이드에 사용되므로 사용자에게 공개할 필요가 없습니다. 따라서 도메인을 공용 DNS에 등록하지 말고, 설치 작업 머신에서 hosts 바인딩 방식으로 도메인 연결을 구성할 수 있습니다. /etc/hosts에 poc-launcher.dataflux.cn 도메인 바인딩을 추가하세요.

/etc/hosts
8.XX.176.XX  poc-launcher.dataflux.cn
  • IP 확인 방법
    kubectl get svc -n kube-system
    
/etc/hosts
192.168.100.104   poc-launcher.dataflux.cn
  • IP 확인 방법

배포 프록시

3. 애플리케이션 설치 안내 단계

설치 작업 머신의 브라우저에서 poc-launcher.dataflux.cn에 접속하여 안내 단계에 따라 설치 구성을 완료합니다.

3.1 데이터베이스 구성

  • 데이터베이스 연결 주소는 반드시 내부망 주소를 사용해야 합니다.
  • 여러 하위 애플리케이션의 데이터베이스와 데이터베이스 액세스 계정을 초기화해야 하므로 계정은 반드시 관리자 계정을 사용해야 합니다.

3.2 캐시 서비스 구성

  • 활성화하지 않을 수도 있습니다. 활성화하지 않으면 기본 캐시 서비스가 사용됩니다.
  • 활성화하는 경우 Redis 연결 주소를 입력하세요. 단일 모드, 프록시 모드 및 주종 모드의 Redis 클러스터 버전을 지원합니다.

launcher-cache.png

3.3 시계열 엔진 구성

  • GuanceDB의 insert와 select를 입력합니다.

3.4 로그 엔진 구성

  • GuanceDB의 insert와 select를 입력합니다.
  • GuanceDB의 insert와 select를 입력합니다.
  • 연결 주소는 반드시 내부망 주소를 사용해야 합니다.
  • 계정은 반드시 관리자 계정을 사용해야 합니다.

3.5 기타 설정

  • Guance 관리 백엔드의 관리자 계정 초기 계정 이름과 이메일
  • 클러스터 노드 내부망 IP(자동으로 가져오며, 올바른지 확인해야 합니다)
  • 기본 도메인 및 각 하위 애플리케이션의 서브도메인 구성입니다. 기본 서브도메인은 다음과 같으며 필요에 따라 수정할 수 있습니다.
  • dataflux 【사용자 프런트엔드】
  • df-api 【사용자 프런트엔드 API】
  • df-management 【관리 백엔드】
  • df-management-api 【관리 백엔드 API】
  • df-websocket 【Websocket 서비스】
  • df-func 【Func 플랫폼】
  • df-openapi 【API 서비스】
  • df-external-api 구성 API】
  • df-urls 도메인 목록 서비스】
  • df-static-res 【정적 리소스 사이트】
  • df-kodo 【kodo】(DataWay 호스트 배포에 사용되며, 컨테이너로 DataWay를 배포하는 경우에는 연결하지 마세요)

3.6 설치 정보

방금 입력한 정보를 요약하여 표시합니다. 정보 입력에 오류가 있으면 이전 단계로 돌아가 수정할 수 있습니다.

3.7 애플리케이션 구성 파일

설치 프로그램은 앞선 단계에서 제공한 설치 정보를 기반으로 애플리케이션 구성 템플릿을 자동으로 초기화합니다. 그러나 모든 애플리케이션 템플릿을 하나씩 확인하고 개인화된 애플리케이션 구성을 수정해야 합니다. 자세한 구성 설명은 설치 화면을 참조하세요.

확인에 문제가 없으면 구성 파일 생성을 제출합니다.

3.8 애플리케이션 이미지

  • 올바른 공유 스토리지, 즉 앞선 단계에서 생성한 storage class 이름을 선택합니다.
  • 애플리케이션 이미지는 선택한 Launcher 버전에 따라 자동으로 입력되므로 수정할 필요가 없습니다. 확인에 문제가 없으면 애플리케이션 생성을 시작합니다.

3.9 애플리케이션 상태

이곳에는 모든 애플리케이션 서비스의 시작 상태가 표시됩니다. 이 과정에서는 모든 이미지를 다운로드해야 하며, 몇 분에서 십여 분까지 소요될 수 있습니다. 모든 서비스가 성공적으로 시작된 후에야 설치가 성공한 것으로 간주됩니다.

주의: 서비스 시작 과정에서 이 페이지를 닫지 말고 계속 유지하세요. 마지막에 "버전 정보 기록 성공" 안내가 표시되고 오류 창이 나타나지 않아야 설치가 성공한 것입니다!

3.10 도메인 연결

df-kodo.dataflux.cn을 제외한 다른 모든 서브도메인을 SLB 공인 IP 주소 또는 엣지 노드 ingress 주소로 연결합니다:

  • dataflux.dataflux.cn
  • df-api.dataflux.cn
  • df-management.dataflux.cn
  • df-management-api.dataflux.cn
  • df-openapi.dataflux.cn
  • df-func.dataflux.cn
  • df-external-api.dataflux.cn
  • df-static-res.dataflux.cn

4. DataWay 설치(선택 사항)

배포가 완료된 후 DataWay를 설치할 수 있습니다. 오른쪽 상단의 설정을 클릭하고 【데이터 게이트웨이 설치】를 선택하세요. DataWay 이름과 바인딩 주소를 입력하고 【원클릭 설치】를 클릭합니다. 설치가 성공하면 안내가 표시됩니다. 다른 방법을 사용하여 DataWay 설치를 진행할 수도 있습니다.

5. 설치 완료 후

배포가 완료된 후 활성화가 필요합니다. 사용 시작 방법 매뉴얼을 참조하세요.

설치 과정에서 문제가 발생하여 재설치가 필요한 경우 유지보수 매뉴얼을 참조하세요.

6. 매우 중요한 단계!!!

위 단계를 거쳐 Guance 설치가 완료되었으면 검증을 진행할 수 있습니다. 검증에 문제가 없다면, launcher 서비스를 내려 잘못된 접근으로 애플리케이션 구성이 손상되는 것을 방지하는 것이 매우 중요한 단계입니다. 운영 작업 머신에서 다음 명령을 실행하여 launcher 서비스의 pod 복제본 수를 0으로 설정할 수 있습니다:

kubectl patch deployment launcher \
-p '{"spec": {"replicas": 0}}' \
-n launcher

문서 평가

이 페이지가 도움이 되었나요?