As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Atualizar pipelines de Ingestão do Amazon OpenSearch
Você pode atualizar os pipelines de Ingestão do Amazon OpenSearch usando AWS Management Console, AWS CLI ou a API de Ingestão do OpenSearch. A Ingestão do OpenSearch 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.
Tópicos
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 público do OpenSearch Service e uma coleção da tecnologia sem servidor do OpenSearch.
-
Quando você atualiza a configuração YAML de um pipeline, a Ingestão do OpenSearch 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, a Ingestão do OpenSearch atualiza automaticamente seu pipeline para a versão secundária compatível mais recente 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
A Ingestão do OpenSearch usa as seguintes permissões do IAM para atualizar pipelines:
-
osis:UpdatePipeline
– atualizar um pipeline. -
osis:ValidatePipeline
– verifica se a configuração do pipeline é válida. -
iam:PassRole
– passa o perfil de pipeline para a Ingestão do OpenSearch 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 de Ingestão do Amazon OpenSearch usando AWS Management Console, AWS CLI ou a API de Ingestão do OpenSearch.
Como atualizar um pipeline
-
Faça login no console do Amazon OpenSearch Service em https://console.aws.amazon.com/aos/home
. -
No painel de navegação à esquerda, selecione Pipelines.
-
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.
-
Quando terminar de fazer as alterações, selecione Salvar.
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-units11
\ --max-units18
Para atualizar um pipeline de Ingestão de OpenSearch usando a API de Ingestão do OpenSearch, chame a operação UpdatePipeline.
Implantações azul/verde para atualizações de pipeline
A Ingestão do OpenSearch 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.
A Ingestão do OpenSearch bloqueia o ajuste de escala automático durante implantações 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, a Ingestão do OpenSearch pode atualizar automaticamente seu pipeline para a versão secundária mais recente compatível com a versão principal do Data Prepper especificada na configuração do pipeline. Por exemplo, você pode ter version: "2"
em sua configuração de pipeline, e a Ingestão do OpenSearch inicialmente ter provisionado 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, a Ingestão do OpenSearch 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. A Ingestão do OpenSearch não pode atualizar a versão principal do pipeline, a menos que você altere manualmente a opção version
na configuração do pipeline.