Datadog Operator는 Kubernetes 및 OpenShift에 Datadog Agent를 배포하는 방법입니다. 커스텀 리소스 상태에서 배포 상태, 기본 상태 및 오류를 보고하고 더 높은 레벨의 설정 옵션을 통해 잘못된 설정의 위험을 방지합니다.

전제 조건

Datadog Operator를 사용하려면 다음의 전제 조건을 만족해야 합니다.

• Kubernetes 클러스터 버전 v1.20.X+: 테스트는 v1.20.0+에서 수행되었으며, v1.11.0+에서 지원되어야 합니다. 이전 버전의 경우 제한된 CRD 지원으로 인해 Operator가 예상대로 작동하지 않을 수 있습니다.
• datadog-operator 배포용 Helm.
• datadog-agent 설치용 Kubectl CLI.

오퍼레이터로 에이전트 배포

1. Datadog 오퍼레이터를 설치합니다:

   helm repo add datadog https://helm.datadoghq.com
   helm install my-datadog-operator datadog/datadog-operator
   

2. API 및 앱 키로 Kubernetes 시크릿을 생성합니다.

   kubectl create secret generic datadog-secret --from-literal api-key=<DATADOG_API_KEY> --from-literal app-key=<DATADOG_APP_KEY>
   

   <DATADOG_API_KEY> 및 <DATADOG_APP_KEY>를 해당 Datadog API 및 애플리케이션 키로 교체하세요.

3. Datadog Agent 배포 설정 사양을 사용하여 datadog-agent.yaml 파일을 만듭니다. 가장 간단한 설정은 다음과 같습니다.

   kind: DatadogAgent
   apiVersion: datadoghq.com/v2alpha1
   metadata:
     name: datadog
   spec:
     global:
       site: <DATADOG_SITE>
       credentials:
         apiSecret:
           secretName: datadog-secret
           keyName: api-key
         appSecret:
           secretName: datadog-secret
           keyName: app-key
     override:
       clusterAgent:
         image:
           name: gcr.io/datadoghq/cluster-agent:latest
       nodeAgent:
         image:
           name: gcr.io/datadoghq/agent:latest
   

   <DATADOG_SITE>를 Datadog 사이트로 교체하세요. 귀하의 사이트는 입니다. (오른쪽에 올바른 사이트가 선택되었는지 확인합니다.)

4. 위의 설정 파일로 Datadog 에이전트를 배포합니다:

   kubectl apply -f /path/to/your/datadog-agent.yaml
   

전제 조건

• Helm
• 새로 설치하는 경우 Helm Datadog repo를 추가합니다:

  helm repo add datadog https://helm.datadoghq.com
  helm repo update
  

차트 설치

1. 빈 datadog-values.yaml 파일을 생성합니다. 이 파일에 지정되지 않은 파라미터는 기본적으로 values.yaml에 설정된 파라미터로 설정됩니다.

2. Datadog API 키 및 앱 키를 저장할 Kubernetes 비밀을 만듭니다.

   kubectl create secret generic datadog-secret --from-literal api-key=$DD_API_KEY --from-literal app-key=$DD_APP_KEY
   

3. 비밀을 참조하려면 다음 파라미터를 datadog-values.yaml에 설정하세요.

   datadog:
    apiKeyExistingSecret: datadog-secret
    appKeyExistingSecret: datadog-secret
    site: <DATADOG_SITE>
   clusterAgent:
    metricsProvider:
     enabled: true
   

   <DATADOG_SITE>를 Datadog 사이트로 교체하세요. 귀하의 사이트는 입니다. (오른쪽에 올바른 사이트가 선택되었는지 확인합니다.)

4. 다음 명령을 실행합니다:

   helm install <RELEASE_NAME> \
    -f datadog-values.yaml \
    --set targetSystem=<TARGET_SYSTEM> \
    datadog/datadog
   

• <RELEASE_NAME>: 릴리스 이름. 예: datadog-agent.

• <TARGET_SYSTEM>: 운영체제 이름. 예: linux 또는 windows.

참고: Helm 2.x를 사용하는 경우 다음을 실행하세요.

helm install --name <RELEASE_NAME> \
 -f datadog-values.yaml \
 --set targetSystem=<TARGET_SYSTEM> \
 datadog/datadog

다음 명령은 위 지침에 따라 생성된 모든 Kubernetes 리소스를 삭제합니다.

kubectl delete datadogagent datadog
helm delete my-datadog-operator

허용 오차 사용 정보를 포함하여 Datadog Operator 설정에 대한 자세한 내용은 Datadog Operator 고급 설정 가이드를 참조하세요.

<RELEASE_NAME> 디플로이먼트를 제거/삭제하려면:

helm uninstall <RELEASE_NAME>

datadog-agent.yaml에서 Datadog 커스텀 리소스(CR)에 다음을 추가합니다.

agent:
  config:
    securityContext:
      runAsUser: <USER_ID>
      supplementalGroups:
        - <DOCKER_GROUP_ID>

datadog-values.yaml 파일에 다음을 추가합니다.

datadog:
  securityContext:
      runAsUser: <USER_ID>
      supplementalGroups:
        - <DOCKER_GROUP_ID>

컨테이너 이미지 레지스트리를 수정하려면 컨테이너 레지스트리 변경하기 가이드를 참조하세요.

배포 지역에서 Google 컨테이너 레지스트리 (gcr.io/datadoghq)에 액세스할 수 없는 경우, values.yaml 파일에서 다음 설정이 포함된 다른 레지스트리를 사용합니다:

• 퍼블릭 Amazon ECR 레지스트리 (public.ecr.aws/datadog)의 경우 다음을 사용합니다.

  registry: public.ecr.aws/datadog
  

• 도커 허브 레지스트리 (docker.io/datadog)인 경우 다음을 사용합니다:

  registry: docker.io/datadog
  

참고:

• Datadog 차트가 AWS 환경에 배포되는 경우 퍼블릭 Amazon ECR 레지스트리(public.ecr.aws/datadog)를 사용하는 것이 좋습니다.