Crie seu próprio arquivo de manifesto

Você pode criar seu próprio arquivo de manifesto usando Helm para atender a todas as suas necessidades, como definir o proxy que deseja usar. Para entender todo o poder do Helm, recomendamos que você leia como instalar a integração do Kubernetes usando o Helm antes de ler este documento.

Compatibilidade e requisitos

• Certifique-se de que o Helm corresponda à sua versão de integração do Kubernetes. Por exemplo, a versão 3 da integração do Kubernetes requer a versão 3 do Helm.

• Uma conta New Relic . Não tem um? Cadastre-se gratuitamente! Não é necessário cartão de crédito.

• Sua New Relic

  chave de licença

  .

• Seu cluster faz o nome do Kubernetes.

  • Se precisar de um nome de exibição para seu cluster, você poderá usar a saída do seguinte comando:

    bash

    Copiar

    $
    kubectl config current-context

Modelagem de integração do Kubernetes com Helm

1. Adicione o repositório de gráficos do New Relic Helm executando:

   bash

   Copiar

   $
   helm repo add newrelic https://helm-charts.newrelic.com

2. Crie um arquivo chamado values-newrelic.yaml, que será utilizado para definir sua configuração, que segue esta estrutura:

   Importante

   Consulte nossa documentação de instalação do Helm para saber como configurá-lo.

   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: true
   nri-metadata-injection:
     # Deploy our webhook to link APM and Kubernetes entities
     enabled: true
   nri-kube-events:
     # Report Kubernetes events
     enabled: true
   newrelic-logging:
     # Report logs for containers running in the cluster
     enabled: true
   kube-state-metrics:
     # Deploy kube-state-metrics in the cluster.
     # Set this to true unless it is already deployed.
     enabled: true

   Copiar

3. Certifique-se de que tudo esteja configurado corretamente no gráfico executando o seguinte comando. Observe que estamos especificando --dry-run e --debug, portanto nada é instalado nesta etapa:

   bash

   Copiar

   $
   helm upgrade --install newrelic newrelic/nri-bundle \
   >
   --namespace newrelic --create-namespace \
   >
   -f values-newrelic.yaml \
   >
   --dry-run \
   >
   --debug

   Observe e modifique os seguintes valores:

   Observe e ajuste os seguintes sinalizadores:

   • global.licenseKey=YOUR_NEW_RELIC_LICENSE_KEY: deve ser definido como um chave de licençaválido para sua conta.
   • global.cluster=K8S_CLUSTER_NAME: Usado para identificar o cluster na interface New Relic , portanto deve ser um valor descritivo não usado por nenhum outro cluster do Kubernetes configurado em sua conta New Relic .
   • kube-state-metrics.enabled=true: defina como true para instalar automaticamente a métrica do estado do Kube (KSM). Isso é necessário para que nossa integração seja executada. Você pode definir isso como falso se o KSM já estiver presente em seu cluster, mesmo que esteja em um namespace diferente.
   • newrelic-prometheus-agent.enabled=true: Defina isto para implantar nosso agente Prometheus, que coleta automaticamente dados do endpoint Prometheus presente no cluster.
   • nri-metadata-injection.enabled=true: Defina isto para instalar nosso webhook mínimo, que adiciona variáveis de ambiente que, por sua vez, permitem vincular o aplicativo instrumentado com New Relic APM ao Kubernetes.

   Dica

   Nossos gráficos do Kubernetes possuem um conjunto abrangente de sinalizadores e configurações que você pode editar para melhor atender às suas necessidades específicas. Confira abaixo como configurar a integração para ver o que você pode modificar.

4. Modele a integração do Kubernetes executando:

   bash

   Copiar

   $
   helm template newrelic newrelic/nri-bundle \
   >
   --namespace newrelic --create-namespace \
   >
   -f values-newrelic.yaml > templated-nri-bundle.yaml

5. Aplique o manifesto gerado executando:

   bash

   Copiar

   $
   kubectl -n newrelic apply -f templated-nri-bundle.yaml

Atualizar usando manifesto

1. Atualize o repositório de gráficos local executando:

   bash

   Copiar

   $
   helm repo update

2. Modele o arquivo executando:

   bash

   Copiar

   $
   helm template newrelic newrelic/nri-bundle \
   >
   --namespace newrelic --create-namespace \
   >
   -f values-newrelic.yaml > new-templated-nri-bundle.yaml

3. Desinstale a versão anterior da integração do Kubernetes, que usa o manifesto anterior, e aplique a nova executando:

   bash

   Copiar

   $
   kubectl -n newrelic delete -f templated-nri-bundle.yaml
   $
   kubectl -n newrelic apply -f new-templated-nri-bundle.yaml

Desinstalar a integração do Kubernetes

Para desinstalar a integração do Kubernetes usando Helm, execute:

$
kubectl -n newrelic delete -f templated-nri-bundle.yaml