AutoTrace 웹훅 업데이트

Instana AutoTrace 웹훅은 계측을 자동으로 업데이트할 수 없습니다. 따라서, 기존 계측을 제거한 후 Helm 배포를 사용하여 웹훅을 다시 설치함으로써 수동으로 업데이트해야 합니다.

참고: 계측기는 이미지를 icr.io/instana/instrumentation 통해 전달됩니다. Instana values.yaml 파일에서 버전 태그를 지정하여 instana-autotrace-webhookHelm 차트가 최신 icr.io/instana/instrumentation 이미지를 사용하도록 정기적으로 업데이트되도록 합니다.

Instana 의 AutoTrace 웹훅 및 계측을 업데이트하려면 다음 단계를 완료하십시오:

  1. 다음 명령어를 실행하여 현재 웹훅 설치를 제거하십시오:

    helm uninstall --namespace instana-autotrace-webhook instana-autotrace-webhook
  2. 로컬 Helm 설치 환경에서 다음 명령어를 실행하여 Helm 차트 저장소를 업데이트하십시오:

    helm repo update
  3. 다음 명령을 실행하여 instana-autotrace-webhookHelm 차트 배포를 다시 설치하십시오:

    helm install --create-namespace --namespace instana-autotrace-webhook instana-autotrace-webhook \
      --repo https://agents.instana.io/helm instana-autotrace-webhook \
      --set webhook.imagePullCredentials.password=<download_key> --set <initial-custom-flags>
  4. 배포를 다시 시작하여 새로운 변환 및 계측 설정을 적용받은 새 애플리케이션 포드의 시작을 트리거하십시오.

  1. 다음 명령을 실행하여 상위 리소스를 다시 시작하십시오:

    kubectl rollout restart deployment <deployment-name> -n <deployment-ns>
  2. 웹훅 릴리스 1.304.6 부터 업그레이드 절차가 간소화되었습니다. 이제 웹훅은 기본적으로 상위 레벨 리소스 대신 파드를 직접 수정합니다. 업그레이드를 적용하려면 배포를 다시 시작할 수 있습니다.

보다 이전 버전의 1.304.6웹훅을 사용하거나, 수동으로 를 --set autotrace.enableHigherLevelResourceMutation=true활성화하는 경우, 웹훅은 배포 수준에서 리소스를 변경합니다. 이 경우, 단순히 배포를 다시 시작하는 것만으로는 충분하지 않습니다. 변환이 제대로 적용되도록 상위 리소스를 재배치하십시오.

중요: 업그레이드 과정을 간소화하고 재시작 기반 방식을 사용하려면 웹훅 릴리스 1.304.6 또는 그 이후 버전으로 업그레이드하십시오.

상위 수준 리소스를 재배포하지 않고 업그레이드하기

1.304.6보다 이전 버전의 웹훅을 실행 중인 경우, 상위 레벨 리소스 변경 기능이 기본적으로 활성화됩니다. 웹훅은 배포 사양에 모니터링 기능을 통합합니다. 새로운 계측 버전으로 업그레이드하려면 해당 상위 수준 리소스를 다시 배포해야 합니다. 포드를 다시 시작하는 것만으로는 충분하지 않습니다.

상위 수준 리소스를 재배포할 수 없는 경우, 서비스 가능성 스크립트를 사용하여 해당 리소스에서 내장된 계측 기능을 제거하십시오: autotrace-mutating-webhook 서비스 가능성 스크립트.

스크립트를 실행하기 전에 다음 단계를 완료하십시오.
  1. 웹훅을 릴리스 1.304.6 버전 이상으로 업그레이드하세요.
  2. 상위 레벨 리소스 변경 기능이 비활성화되어 있는지 확인하십시오. 버전 1.304.6 부터는 이 기능이 기본적으로 비활성화됩니다.

스크립트를 실행하기 전에 다음 단계를 완료하십시오. 웹훅이 여전히 상위 레벨 리소스를 변경하도록 구성되어 있다면, 스크립트가 정리한 리소스에 다시 계측 코드를 삽입하게 됩니다.

중요: 웹훅을 업그레이드하고 상위 레벨 리소스 변경 기능을 비활성화하면, 웹훅은 개별 파드만 변경합니다. 배포를 다시 시작하면 향후 업그레이드를 적용할 수 있습니다. 상위 수준의 리소스를 다시 배포할 필요는 없습니다.