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 cluster enabled: truenri-metadata-injection: # Deploy our webhook to link APM and Kubernetes entities enabled: truenri-kube-events: # Report Kubernetes events enabled: truenewrelic-logging: # Report logs for containers running in the cluster enabled: truekube-state-metrics: # Deploy kube-state-metrics in the cluster. # Set this to true unless it is already deployed. enabled: true
- 다음 명령을 실행하여 차트의 모든 항목이 올바르게 구성되었는지 확인하십시오.
--dry-run
및--debug
을 지정하므로 이 단계에서는 아무 것도 설치되지 않습니다.
$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
: 유효한 New Relic으로 설정당신의 계정을 위해.
global.cluster=K8S_CLUSTER_NAME
: New Relic에서 클러스터를 식별할 수 있도록 설정하므로 고유한 설명 값이어야 합니다.kube-state-metrics.enabled=true
:true
로 설정하면 통합 실행에 필요한 KSM(Kube State Metrics)이 자동으로 설치됩니다. KSM이 다른 네임스페이스에 있더라도 클러스터에 이미 있는 경우 이를false
로 설정할 수 있습니다.newrelic-prometheus-agent.enabled=true
: 클러스터에 있는 Prometheus 엔드포인트에서 자동으로 데이터를 수집하는 Prometheus 에이전트를 배포하려면true
로 설정합니다.nri-metadata-injection.enabled=true
: New Relic APM으로 계측된 애플리케이션을 Kubernetes에 연결할 수 있는 환경 변수를 추가하는 최소 웹후크를 설치하려면true
로 설정합니다.
팁
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