Helm을 사용하여 고유한 매니페스트 파일을 생성하여 사용하려는 프록시 설정과 같은 모든 요구 사항을 충족할 수 있습니다. Helm의 모든 기능을 이해하려면 이 문서를 살펴보기 전에 Helm을 사용하여 Kubernetes 통합을 설치하는 방법을 읽어보는 것이 좋습니다.
호환성 및 요구 사항
Helm 이 Kubernetes 통합 버전과 일치하는지 확인하십시오. 예를 들어 Kubernetes 통합 버전 3에는 Helm 버전 3이 필요합니다.
New Relic 계정. 하나가 없습니까? 무료 가입! 신용 카드가 필요하지 않습니다.
귀하의 뉴렐릭
.
Kubernetes 클러스터의 이름입니다.
클러스터의 표시 이름이 필요한 경우 다음 명령의 출력을 사용할 수 있습니다.
bash$kubectl config current-context
Helm과 Kubernetes 통합 템플릿 작성
중요
매니페스트를 사용한 설치 및 업그레이드는 지원되지 않으며 오류가 발생하기 쉽습니다. 이것이 귀하의 환경에 필요한 접근 방식임을 완전히 확신하십시오.
다음을 실행하여 New Relic Helm 차트 리포지토리를 추가합니다.
bash$helm repo add newrelic https://helm-charts.newrelic.com다음 구조를 따르는 구성을 정의하는 데 사용할
values-newrelic.yaml
파일을 만듭니다.중요
Helm 설치 설명서를 참조하여 구성 방법을 알아보세요.
global:licenseKey: _YOUR_NEW_RELIC_LICENSE_KEY_cluster: _K8S_CLUSTER_NAME_newrelic-prometheus-agent:# Automatically scrape prometheus metrics for annotated services in the clusterenabled: truenri-metadata-injection:# Deploy our webhook to link APM and Kubernetes entitiesenabled: truenri-kube-events:# Report Kubernetes eventsenabled: truenewrelic-logging:# Report logs for containers running in the clusterenabled: truekube-state-metrics:# Deploy kube-state-metrics in the cluster.# Set this to true unless it is already deployed.enabled: true다음 명령을 실행하여 차트의 모든 항목이 올바르게 구성되었는지 확인하십시오.
--dry-run
및--debug
을 지정하므로 이 단계에서는 아무 것도 설치되지 않습니다.bash$helm upgrade --install newrelic newrelic/nri-bundle \>--namespace newrelic --create-namespace \>-f values-newrelic.yaml \>--dry-run \>--debug다음 값을 확인하고 수정하십시오.
다음 플래그를 확인하고 조정하십시오.
global.licenseKey=YOUR_NEW_RELIC_LICENSE_KEY
: 계정에 유효한 로 설정되어야 합니다.global.cluster=K8S_CLUSTER_NAME
: 뉴렐릭 UI 에서 클러스터를 식별하는 데 사용되므로 뉴렐릭 계정에 구성된 다른 쿠버네티스 클러스터에서는 사용되지 않는 기술 값이어야 합니다.kube-state-metrics.enabled=true
: Kube State 지표(KSM)를 자동으로 설치하려면 이를true
로 설정합니다. 이는 통합을 실행하는 데 필요합니다. KSM이 클러스터에 이미 있으면 다른 네임스페이스에 있더라도 이를 false로 설정할 수 있습니다.newrelic-prometheus-agent.enabled=true
: 이를 구현하다, 배포하다로 설정하면 클러스터에 있는 Prometheus 엔드포인트에서 데이터를 자동으로 수집합니다.nri-metadata-injection.enabled=true
: 환경 변수를 추가하는 최소 웹후크를 설치하려면 이를 설정하여 뉴렐릭 APM 과 함께 제공되는 기능을 Kubernetes에 연결할 수 있습니다.
팁
Kubernetes 차트에는 특정 요구 사항을 더 잘 충족하기 위해 편집할 수 있는 포괄적인 플래그 및 설정 세트가 있습니다. 수정할 수 있는 사항을 알아보려면 아래에서 통합을 구성하는 방법을 확인하세요.
다음을 실행하여 Kubernetes 통합을 템플릿화합니다.
bash$helm template newrelic newrelic/nri-bundle \>--namespace newrelic --create-namespace \>-f values-newrelic.yaml > templated-nri-bundle.yaml다음을 실행하여 생성된 매니페스트를 적용합니다.
bash$kubectl -n newrelic apply -f templated-nri-bundle.yaml
매니페스트를 사용하여 업그레이드
중요
매니페스트를 사용한 설치 및 업그레이드는 지원되지 않으며 오류가 발생하기 쉽습니다. 이것이 귀하의 환경에 필요한 접근 방식임을 완전히 확신하십시오.
다음을 실행하여 로컬 차트 저장소를 업데이트합니다.
bash$helm repo update다음을 실행하여 파일을 템플릿화합니다.
bash$helm template newrelic newrelic/nri-bundle \>--namespace newrelic --create-namespace \>-f values-newrelic.yaml > new-templated-nri-bundle.yaml이전 매니페스트를 사용하는 Kubernetes 통합의 이전 버전을 제거하고 다음을 실행하여 새 매니페스트를 적용합니다.
bash$kubectl -n newrelic delete -f templated-nri-bundle.yaml$kubectl -n newrelic apply -f new-templated-nri-bundle.yaml
Kubernetes 통합 제거
Helm을 사용하여 Kubernetes 통합을 제거하려면 다음을 실행하십시오.
$kubectl -n newrelic delete -f templated-nri-bundle.yaml