Esta página se aplica à Apigee e à 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 é realizada 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 iniciar alguns recursos, a Apigee exige uma atualização de manutenção.
- Melhor performance: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.
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 futuras manutenções automáticas 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.
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 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 optar por receber uma notificação sobre uma manutenção futura no e-mail pelo menos uma semana antes da data 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.
- Ative as notificações de manutenção.
- Faça isso pelo menos 7 dias antes de a Apigee programar uma atualização de manutenção para seu recurso. Caso contrário, você não se inscreveu para receber notificações com antecedência suficiente para que o sistema envie um aviso sobre a manutenção.
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 de todos os recursos do Apigee que têm janelas de manutenção em um projeto específico. Você recebe uma notificação por recurso.
Perguntas frequentes
Confira a seguir 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 em que a manutenção 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 sete dias antes de uma atualização de manutenção ser programada para seu recurso.
- 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 se isso acontecer.