마스터 및 노드 에이전트

설치 안내 페이지에 따라 마스터 및 노드 에이전트의 설치 과정을 진행합니다.

Install Master and Node Agents
Figure 1. Install Master and Node Agents

프로젝트 액세스 키 (구 라이선스) 발급

설치 페이지의 "프로젝트 액세스 키를 생성해 주세요" 문구 아래에 있는 버튼을 클릭하여 키를 발급받습니다. 발급받은 키는 각 에이전트들이 앞서 생성한 와탭 쿠버네티스 프로젝트에 접근하기 위한 역할을 합니다.

사전 환경 점검 및 설정

사용자의 쿠버네티스 환경에 따라 사전 환경 설정이 필요한 경우가 있습니다.

Istio 환경

Istio 환경이라면 아래 명령을 실행하여 Istio 모니터링에 필요한 자원을 생성합니다.

kubectl create namespace whatap-monitoring
kubectl label namespace whatap-monitoring istio-injection=enabled
kubectl apply -f - <<EOF
apiVersion: networking.istio.io/v1alpha3
kind: ServiceEntry
metadata:
    name: whatap-external
spec:
    hosts:
    - whatap-proxy1
    - whatap-proxy2
    addresses:
    - 13.124.11.223
    - 13.209.172.35
    ports:
    - name: proxy
      number: 6600
      protocol: tcp
      location: MESH_EXTERNAL
EOF
GKE 환경

GKE(Google Kubernetes Engine)의 경우 사용자 클러스터 생성 후 아래 명령을 통해 권한 설정을 수행합니다.

#GKE 권한설정
ACCOUNT=$(gcloud info --format='value(config.account)')
kubectl create clusterrolebinding owner-cluster-admin-binding \
    --clusterrole cluster-admin \
    --user $ACCOUNT
gcloud 명령 설치는 https://cloud.google.com/sdk/install를 참조하세요.
OpenShift 환경

설치 안내 화면 상에서 openshift_scc.yaml 파일을 다운로드하고, 아래 명령을 통해 설치합니다.

oc create -f whatap_openshift_scc.yaml

마스터 및 노드 에이전트 설치

사용자의 쿠버네티스 버전과 Container Runtime에 맞는 YAML 파일을 다운로드한 후 해당 YAML 파일을 이용하여 에이전트를 설치하는 단계입니다.

사용자 쿠버네티스 버전은 다음 명령어를 통해 확인 가능합니다.

kubectl version | grep Server

Amazon (EKS), Google (GKE), Azure (AKS), 혹은 설치형 쿠버네티스에서 Container Runtime을 별도로 지정하지 않은 경우 Docker YAML을 다운로드합니다.

사용 쿠버네티스 환경에 맞는 YAML 파일을 다운로드합니다.

Install Master and Node Agents
Figure 2. Download Master and Node Agent YAML file

위에서 다운로드한 YAML 파일을 통해 와탭 에이전트 Pod를 생성합니다. (아래 whatap_kube.yaml 파일 이름을 위에서 다운로드한 실제 파일 이름으로 변경합니다)

kubectl -f whatap_kube.yaml apply

와탭 마스터 에이전트와 노드 에이전트 Pod가 정상적으로 생성되었는지 확인합니다.

kubectl get pods -n whatap-monitoring
NAME                                  READY   STATUS    RESTARTS   AGE
whatap-master-agent-cb769958c-tclkl   2/2     Running   0          5d
whatap-node-agent-8p8vk               2/2     Running   0          5d
whatap-node-agent-cj8jb               2/2     Running   0          5d
whatap-node-agent-d94fj               2/2     Running   0          5d
whatap-node-agent-l42sf               2/2     Running   0          5d
whatap-node-agent-mkppb               2/2     Running   0          5d
whatap-node-agent-pdwlr               2/2     Running   0          5d
whatap-node-agent-zf6bv               2/2     Running   0          5d

마스터 및 노드 에이전트의 설치가 완료되면 쿠버네티스 환경의 자원 모니터링이 시작되므로 대시보드 메뉴를 통해 자원 모니터링 여부를 확인합니다.

kubectl 명령어 사용 시 -n <네임스페이스> 옵션을 사용하면 특정 네임스페이스를 대상으로 작업을 수행합니다. 와탭 에이전트는 기본적으로 whatap-monitoring이라는 네임스페이스에 설치되므로 -n whatap-monitoring이라는 옵션을 추가한 것입니다.

후속 작업으로 애플리케이션 모니터링을 위한 에이전트 설치를 수행합니다.