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