Atualização dos pipelines OpenSearch de ingestão da Amazon

Você pode atualizar os pipelines OpenSearch de ingestão da Amazon usando a API AWS Management Console AWS CLI, a ou a API de OpenSearch ingestão. OpenSearch A ingestão inicia uma implantação azul/verde quando você atualiza a configuração YAML de um pipeline. Para ter mais informações, consulte Implantações azul/verde para atualizações de pipeline.

Considerações

Considere o seguinte ao atualizar um pipeline:

• Você pode editar os limites de capacidade, as opções de publicação de logs e a configuração do YAML de um pipeline. Você não pode editar o nome ou as configurações de rede.

• Se o pipeline gravar em um coletor de domínio da VPC, você não pode voltar e alterar o coletor para um domínio de VPC diferente após a criação do pipeline. Você deve excluir e recriar o pipeline com o novo coletor. Você ainda pode mudar o coletor de um domínio da VPC para um domínio público, de um domínio público para um domínio VPC ou de um domínio público para outro domínio público.

• Você pode alternar o coletor do pipeline a qualquer momento entre um domínio OpenSearch de serviço público e uma OpenSearch coleção sem servidor.

• Quando você atualiza a configuração YAML de um pipeline, o OpenSearch Inestion inicia uma implantação azul/verde. Para ter mais informações, consulte Implantações azul/verde para atualizações de pipeline.

• Quando você atualiza a configuração YAML de um pipeline, o OpenSearch Ingestion atualiza automaticamente seu pipeline para a versão secundária mais recente compatível da versão principal do Data Prepper especificada na configuração do pipeline. Esse processo mantém seu pipeline atualizado com as últimas correções de bugs e melhorias de desempenho.

• Você ainda pode fazer atualizações no seu pipeline quando ele estiver parado.

Permissões obrigatórias

OpenSearch A ingestão usa as seguintes permissões do IAM para atualizar os pipelines:

• osis:UpdatePipeline – atualizar um pipeline.

• osis:ValidatePipeline – verifica se a configuração do pipeline é válida.

• iam:PassRole— passe a função do pipeline para o OpenSearch Ingestion para que ele possa gravar dados no domínio. Essa permissão só é necessária se você estiver atualizando a configuração YAML do pipeline, não se estiver modificando outras configurações, como publicação de logs ou limites de capacidade.

Por exemplo, a política a seguir concede permissão para atualizar um pipeline:

{
   "Version":"2012-10-17",
   "Statement":[
      {
         "Effect":"Allow",
         "Resource":"*",
         "Action":[
            "osis:UpdatePipeline",
            "osis:ValidatePipeline"
         ]
      },
      {
         "Resource":[
            "arn:aws:iam::{your-account-id}:role/{pipeline-role}"
         ],
         "Effect":"Allow",
         "Action":[
            "iam:PassRole"
         ]
      }
   ]
}

Atualizar pipelines

Você pode atualizar os pipelines OpenSearch de ingestão da Amazon usando a API AWS Management Console AWS CLI, a ou a API de OpenSearch ingestão.

Console

Como atualizar um pipeline

1. Faça login no console do Amazon OpenSearch Service em https://console.aws.amazon.com/aos/home.

2. No painel de navegação à esquerda, selecione Pipelines.

3. Escolhe um pipeline para abrir suas configurações. Você pode editar os limites de capacidade, as opções de publicação de logs e a configuração do YAML de um pipeline. Você não pode editar o nome ou as configurações de rede.

4. Quando terminar de fazer as alterações, selecione Salvar.

CLI

Para atualizar um pipeline usando o AWS CLI, envie uma solicitação update-pipeline. O exemplo de solicitação a seguir carrega um novo arquivo de configuração e atualiza os valores de capacidade mínima e máxima:

aws osis update-pipeline \
  --pipeline-name "my-pipeline" \
  --pipline-configuration-body "file://new-pipeline-config.yaml" \
  --min-units 11 \
  --max-units 18

OpenSearch API de ingestão

Para atualizar um pipeline OpenSearch de ingestão usando a API OpenSearch de ingestão, chame a UpdatePipelineoperação.

Implantações azul/verde para atualizações de pipeline

OpenSearch A ingestão inicia um processo de implantação azul/verde quando você atualiza a configuração YAML de um pipeline.

Azul/verde refere-se à prática de criar um novo ambiente para atualizações de pipeline e rotear o tráfego para o novo ambiente assim que essas atualizações são concluídas. Essa prática minimiza o tempo de inatividade e mantém o ambiente original caso a implantação no novo ambiente seja malsucedida. As implantações azul/verde em si não têm nenhum impacto no desempenho, mas o desempenho poderá mudar se a configuração do pipeline mudar de uma forma que altere o desempenho.

OpenSearch A ingestão bloqueia o escalonamento automático durante implantações em azul/verde. Você continua sendo cobrado somente pelo tráfego do pipeline antigo até que ele seja redirecionado para o novo pipeline. Depois que o tráfego for redirecionado, você será cobrado apenas pelo novo pipeline. Você nunca será cobrado por dois pipelines simultaneamente.

Quando você atualiza o arquivo de configuração YAML de um pipeline, o OpenSearch Ingestion pode atualizar automaticamente seu pipeline para a versão secundária mais recente compatível da versão principal do Data Prepper especificada na configuração do pipeline. Por exemplo, você pode ter version: "2" na configuração do pipeline e a OpenSearch Ingestion inicialmente provisionou o pipeline com a versão 2.1.0. Quando o suporte para a versão 2.1.1 é adicionado e você faz uma alteração na configuração do pipeline, o OpenSearch Ingestion atualiza seu pipeline para a versão 2.1.1.

Esse processo mantém seu pipeline atualizado com as últimas correções de bugs e melhorias de desempenho. OpenSearch A ingestão não pode atualizar a versão principal do seu pipeline, a menos que você altere manualmente a version opção na configuração do pipeline.