Instalando a Custom Edition manualmente

Você pode instalar manualmente a Edição Personalizada Auto-hospedada ( Kubernetes ou Red Hat OpenShift Container Platform ).

Você precisa de permissões de administrador do cluster para implantar a Custom Edition.

Pré-requisitos

Consulte os requisitos para operadores do Instana Enterprise. Para obter mais informações, consulte “ Instana : Operador corporativo ”.
Verifique os requisitos para a instalação da Edição Personalizada Auto-hospedada ( Kubernetes ou Red Hat OpenShift Container Platform ) e os requisitos de acesso à rede de saída para implantações auto-hospedadas do Instana. Certifique-se de que os requisitos sejam atendidos antes de instalar o backend do Instana.
Configure os armazenamentos de dados necessários. Para obter mais informações, consulte “Configurando armazenamentos de dados ”.
Certifique-se de que o config.yaml arquivo foi criado. Este arquivo é necessário para configurar os componentes de back-end. Para obter mais informações sobre os componentes de back-end, consulte Instana backend components.

Procedimento de instalação

Instale o kubectl plug-in. Para obter mais informações, consulte “Instalando o plug-in Instana kubectl ”.
Instale e configure o Operador Empresarial do Instana no seu cluster Kubernetes ou Red Hat OpenShift :
1. Crie um webhook do " TLS Secrets for Admission". Selecione uma das opções a seguir:
  - Usando cert-manager
  - Usando certificados customizados
2. Criar segredos para baixar imagens. Para obter mais informações, consulte Criação de segredos de pull de imagens.
  
  Nota:
  Se você não tiver seu próprio registro no Docker que espelhe o ' artifact-public.instana.io ' e não precisar de segredos de pull, crie um segredo de pull de imagem.
3. Crie e configure o arquivo de valores. Para obter mais informações, consulte Criação e configuração do arquivo de valores.
  
  Nota:
  Antes de instalar o Instana Enterprise Operator, é necessário atualizar o campo imagePullSecrets no arquivo values .
4. Instale o Operador Empresarial d Instana. Para obter mais informações, consulte Instalação do operador do Instana Enterprise.
5. Opcional: use a configuração avançada de operadores. Para obter mais informações, consulte Como usar a configuração avançada de operadores.
  
  Nota:
  Após instalar o Instana Enterprise Operator, você poderá configurá-lo conforme necessário utilizando o arquivo de valores.
Instale os componentes do backend do Instana :
1. Crie namespaces para objetos Core e Unit. Para obter mais informações, consulte Criação de namespaces.
2. Crie segredos de pull de imagem para objetos Core e Unit. Para obter mais informações, consulte Criação de segredos de pull de imagens.
3. Baixe seu arquivo de licença. Para obter mais informações, consulte Baixando o arquivo de licença.
4. Criar segredos:
5. Criar um objeto Core:
  1. Crie um arquivo objeto Core com a configuração básica. Para obter mais informações, consulte a Configuração básica.
  2. Opcional: Configure os recursos de CPU/memória. Para obter mais informações, consulte Recursos de CPU/memória.
  3. Configurar o Aceitador de Agentes. Para obter mais informações, consulte o Agent Acceptor.
  4. Configurar o armazenamento de dados Raw. Para obter mais informações, consulte Armazenamento de intervalos brutos.
  5. Configurar armazenamentos de dados. Para obter mais informações, consulte Armazenamentos de dados.
  6. Opcional: Configure os padrões de retenção de dados. Para obter mais informações, consulte Substituir as configurações padrão de retenção de dados.
  7. Aplique as configurações do Objeto Principal. Para obter mais informações, consulte Aplicação de configurações do Core.
6. Crie um objeto Unit. Para obter mais informações, consulte Criação de uma unidade.
Configure balanceadores de carga e o serviço de gerenciamento de endereços de rede ( DNS ) para os serviços Acceptor e Gateway. Para obter mais informações, consulte “Configurando balanceadores de carga” e “ DNS ”.
Opcional: Ative recursos que não estão ativados por padrão em implantações auto-hospedadas. Para obter mais informações, consulte “Ativação de recursos opcionais para a Edição Personalizada”
Opcional: Cumprir os requisitos da norma FIPS. Para obter mais informações, consulte “Conformidade com os requisitos da FIPS ”.

Recursos necessários: Definições de recursos personalizadas

Definições de Recurso Customizado (CRDs) são extensões da API do Kubernetes.

Os dois CRDs a seguir são necessários durante a implantação do backend do Instana. Eles devem ser instalados no mesmo cluster que o backend do Instana.

cores.instana.io

Um Core representa todos os componentes compartilhados por uma instalação do Instana. Cada Core tem um conjunto de bancos de dados associados, que são usados pelo próprio Core e todos os locatários com suas respectivas unidades locatários que são criadas como membros do Core.

Para obter mais informações, consulte a Referência do API.

units.instana.io

As unidades representam conjuntos de dados individuais na Instana. Internamente, o ` Instana ` possui locatários, que são apenas uma construção lógica. Cada locatário, por sua vez, tem pelo menos uma ou várias unidades de locatário. No que diz respeito à configuração, você sempre configura as unidades do locatário usando o CRD da Unidade Um locatário pode ser um departamento (como SRE, Dev, QA) ou qualquer outro agrupamento lógico. Em um locatário, é possível criar Unidades individuais conforme necessário. Dados de uma unidade não são visíveis por qualquer outra unidade.

Por exemplo, existem dois departamentos: comércio eletrônico e intranet.

ecommerce tem três ambientes: dev, preprod, prod. intranet tem dois ambientes: dev e prod. Nesse caso, é possível criar um ecommerce de locatário com as unidades de locatário dev, preprod e prod e uma intranet de locatário com as unidades de locatário dev e prod

As unidades de locatário são separadas e recebem dados apenas de agentes associados a elas.

Para obter mais informações, consulte a Referência do API.

Dicas

Dica 1

Você também pode consultar a referência do ` API ` executando o comando ` kubectl explain`.

Execute o comando ` kubectl explain --help ` para obter detalhes sobre como usá-lo.

Consulte o seguinte exemplo:

kubectl explain core.spec.serviceProviderConfig
KIND:     Core
VERSION:  instana.io/v1beta2

RESOURCE: serviceProviderConfig <Object>

DESCRIPTION:
     Service provider configuration for SAML or OIDC.

FIELDS:
   basePath     <string> -required-
     Base URL (defaults to "/auth").

   maxAuthenticationLifetimeSeconds     <integer> -required-
     The maximum authentication lifetime (defaults to 604.800).

   maxIDPMetadataSizeInBytes    <integer> -required-
     The maximum IDP metadata size (defaults to 200.000).

Dica 2

Um bom editor, como o VS Code com a extensão Kubernetes, fornece conclusão de comando quando as CRDs são instaladas no cluster.

Consulte o seguinte exemplo:

VS Code