Esta página se aplica à Apigee, mas não à Apigee híbrida.
Confira a documentação da
Apigee Edge.
Esta seção apresenta uma visão geral da manutenção do Apigee.
Para instruções sobre como programar janelas de manutenção, consulte Gerenciar janelas de manutenção da instância do Apigee.
Visão geral
A Apigee faz atualizações regularmente para garantir que o serviço seja confiável, seguro, atualizado e tenha um bom desempenho. A maioria dessas atualizações é feita sem impacto perceptível. Essas atualizações são chamadas de manutenção.
A manutenção geralmente se enquadra nas seguintes categorias:
- Recursos da Apigee: para lançar alguns recursos, a Apigee exige uma atualização de manutenção.
- Melhor desempenho:oferecendo a melhor performance e confiabilidade possíveis.
- Patches e atualizações de segurança: monitoramos continuamente vulnerabilidades de segurança recém-identificadas na nossa pilha de software. Após a descoberta, aplicamos um patch ao sistema para proteger você contra novos riscos.
Impacto da manutenção
Normalmente, a manutenção da Apigee é totalmente integrada. No entanto, durante a manutenção do Apigee, não será possível realizar algumas atividades, como:
- Como criar instâncias
- Anexar um ambiente a uma instância
- Como criar um anexo de endpoint
- Determinada atividade de escalonamento
Configurações de manutenção
A Apigee permite configurar a manutenção para que ocorra no momento mais oportuno para seu aplicativo. Para isso, configure janelas de manutenção.
É possível configurar as seguintes opções para instâncias do Apigee:
- Janela de manutenção: o dia da semana e a hora em que o Apigee programa o início da manutenção.
- Ordem de atualização: define a ordem em que as instâncias são atualizadas em relação a outras instâncias na mesma região. A ordem de atualização pode ser definida como "Semana 1" ou "Semana 2". As instâncias da semana 2 são atualizadas uma semana após as instâncias da semana 1 com a mesma janela de manutenção na mesma região. Você define a ordem de atualização ao configurar uma janela de manutenção.
Observação: "Semana 1" e "Semana 2" se referem às fases de lançamento e aos prazos de notificação (1 semana x 2 semanas). Elas não se referem à primeira ou segunda semana do mês. Por exemplo, um lançamento da "Semana 2" não acontece necessariamente na segunda semana de um mês do calendário. Isso acontece uma semana depois do lançamento da "Semana 1" para essa versão específica.
A Apigee vai programar o início da manutenção no horário especificado. Devido às diferentes configurações dos clientes, a Apigee não pode estimar exatamente quanto tempo a manutenção vai levar. No entanto, ela geralmente leva várias horas.
Se uma janela de manutenção for configurada para um recurso, as manutenções automáticas futuras serão programadas para respeitar essas preferências. Se uma janela de manutenção não for especificada para seu recurso, a manutenção poderá começar a qualquer momento.
A Apigee fará o possível para respeitar as janelas de manutenção. No entanto, para manter a compatibilidade e a segurança em toda a frota, às vezes precisamos atualizar sua instância fora dos horários preferidos.
Frequência e estabilidade do lançamento
A Apigee não lança todas as versões de execução para instâncias com janelas de manutenção. As atualizações geralmente são agrupadas e lançadas somente quando uma versão é considerada altamente estável em toda a frota. Como resultado, suas instâncias podem pular vários números de versão entre as atualizações. Os novos lançamentos de janelas de manutenção são anunciados nas notas de lançamento do Apigee.
Janelas de congelamento e exclusão
No momento, a Apigee não é compatível com períodos de congelamento ou exclusão de manutenção definidos pelo cliente. Depois que um lançamento é programado, ele prossegue de acordo com as configurações de janela e ordem de atualização configuradas. Modificar ou limpar as configurações de manutenção depois que um evento de manutenção for agendado não vai cancelar nem adiar o evento.
Práticas recomendadas para janelas de manutenção
Recomendamos que você defina janelas de manutenção nas instâncias de produção, e não nas instâncias de não produção. Isso ocorre devido à seguinte ordem geral de eventos em torno de uma atualização de manutenção:
- Primeiro, o Apigee atualiza todas as instâncias que não têm janelas de manutenção.
- Em seguida, o Apigee programa atualizações para todas as instâncias que têm janelas de manutenção. Essas atualizações têm pelo menos uma semana (para a ordem de atualização da Semana 1) ou duas semanas (para a ordem de atualização da Semana 2) de prazo de antecedência.
- Se você tiver ativado o recebimento de comunicações sobre os próximos eventos de manutenção da Apigee, a Apigee vai enviar um e-mail com uma notificação sobre a manutenção programada.
- A Apigee realiza as atualizações de manutenção nos horários programados.
Portanto, uma notificação de manutenção futura também significa que as mesmas atualizações já foram aplicadas a todas as suas instâncias sem janelas de manutenção definidas. Se você deixar as instâncias de não produção sem janelas de manutenção, poderá garantir que elas recebam as atualizações do sistema primeiro. Além disso, use as notificações de manutenção futura como um aviso para testar ou visualizar as atualizações em um ambiente de não produção.
Exemplo de manutenção
Suponha que você trabalhe como desenvolvedor em um varejista gerenciando um serviço de carrinho de compras e tenha uma instância da Apigee para um ambiente de produção. Você quer que a manutenção comece no momento em que a instância processa a menor quantidade de tráfego, que é por volta da meia-noite aos domingos.
Nesse caso, defina as configurações de manutenção da instância de produção como:
- Janela de manutenção: domingos a partir das 0h UTC
- Ordem de atualização: semana 2
As configurações de manutenção de uma instância no ambiente de preparo seriam semelhantes, mas a ordem de atualização seria definida como "Semana 1". Por fim, nenhuma instância no seu ambiente de desenvolvimento teria uma janela de manutenção configurada. Isso garante que você possa executar testes de aceitação operacional para uma versão de manutenção no ambiente de desenvolvimento e preparo antes que a manutenção chegue à produção. Se algo der errado no ambiente de desenvolvimento ou de teste, você terá tempo para diagnosticar e corrigir o problema. Assim, o ambiente de produção não será afetado.
Notificações de manutenções futuras
Você pode receber uma notificação sobre uma manutenção futura no e-mail pelo menos uma semana (para a Semana 1) ou duas semanas (para a Semana 2) antes do início da manutenção programada. Se você quiser definir um filtro de e-mail para notificações, o título do e-mail será "Próxima manutenção do seu recurso do Apigee [your-resource-name]".
As notificações de manutenção não são enviadas por padrão. Se você quiser receber uma notificação sobre uma manutenção futura, faça o seguinte:
- Defina uma janela de manutenção.
- Ativar as notificações de manutenção.
- Faça isso pelo menos 7 dias (para a semana 1) ou 14 dias (para a semana 2) antes do início do evento de manutenção programado. Caso contrário, você não se inscreveu para receber notificações com antecedência suficiente para que o sistema envie uma notificação sobre a manutenção programada.
As notificações são enviadas para o endereço de e-mail associado à sua Conta do Google. Não é possível configurar um alias de e-mail personalizado (por exemplo, um alias de e-mail de equipe) nem assinar outro endereço de e-mail que não seja o seu.
Ao se inscrever, você ativa as notificações de manutenção para todos os recursos da Apigee que têm janelas de manutenção em um determinado projeto. Você recebe uma notificação por recurso.
Perguntas frequentes
Confira abaixo algumas perguntas frequentes sobre a política de manutenção do Apigee:
Quais práticas recomendadas devo seguir para ter uma experiência de atualização de manutenção tranquila?
Recomendamos que você faça o seguinte para garantir uma experiência de atualização de manutenção tranquila:
- Defina a janela de manutenção para um horário que garanta que ela não seja aplicada nos horários de pico de uso da Apigee.
- Ative as notificações de manutenção para receber um alerta por e-mail pelo menos 7 dias (para a Semana 1) ou 14 dias (para a Semana 2) antes do início da atualização de manutenção programada.
- Use janelas de manutenção diferentes e não sobrepostas para cada recurso. Isso significa que, se houver uma interrupção durante o período de manutenção, você ainda poderá usar o produto com os recursos não afetados.
Por que minhas configurações de manutenção foram ignoradas?
A Apigee fará o possível para respeitar as janelas de manutenção e a ordem de atualização. No entanto, para manter a compatibilidade e a segurança em toda a frota, às vezes precisamos atualizar sua instância fora dos horários preferidos. Você não vai receber uma notificação antecipada se isso acontecer, mas os registros de atualização da instância ainda serão gerados para ela.