Esta página se aplica a Apigee, mas não a Apigee híbrida.
Confira
Apigee Edge documentação.
Esta seção oferece uma visão geral da manutenção da Apigee.
Para instruções sobre como programar janelas de manutenção, consulte Gerenciar janelas de manutenção da instância da Apigee.
Visão geral
A Apigee realiza atualizações de rotina 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 normalmente se enquadra nas seguintes categorias:
- Recursos da Apigee: para lançar alguns recursos, a Apigee exige uma atualização de manutenção.
- Desempenho aprimorado:oferecendo o melhor desempenho e confiabilidade possíveis.
- Patches e atualizações de segurança: monitoramos continuamente as vulnerabilidades de segurança recém-identificadas na nossa pilha de software. Após a descoberta, corrigimos o 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 da Apigee, não é possível realizar determinadas atividades, como:
- Criar novas instâncias
- Anexar um ambiente a uma instância
- Criar um anexo de endpoint
- Determinadas atividades de escalonamento
Configurações de manutenção
A Apigee oferece a capacidade de configurar a manutenção para ocorrer no momento mais oportuno para seu aplicativo. Para isso, configure janelas de manutenção.
É possível configurar as seguintes opções para instâncias da Apigee:
- Janela de manutenção: o dia da semana e a hora em que a Apigee programa a manutenção para começar.
- 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. Defina 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 versus 2 semanas). Eles 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. Ele acontece uma semana após o lançamento da "Semana 1" para essa versão específica.
A Apigee vai programar a manutenção para começar no horário de início especificado que você configurou. Devido às diferentes configurações do cliente, a Apigee não pode estimar exatamente quanto tempo a manutenção vai levar. No entanto, ela normalmente leva várias horas.
Se uma janela de manutenção for configurada para um recurso, a manutenção automática futura será programada para respeitar essas preferências. Se uma janela de manutenção não for especificada para o recurso, a manutenção poderá começar a qualquer momento.
A Apigee vai fazer o possível para respeitar as janelas de manutenção. No entanto, para manter a compatibilidade e a segurança em toda a nossa frota, às vezes precisamos atualizar sua instância fora dos horários preferenciais.
Frequência e estabilidade de lançamento
A Apigee não lança todas as versões de ambiente de execução para instâncias com janelas de manutenção. As atualizações são normalmente agrupadas e lançadas somente quando uma versão é determinada como altamente estável em toda a frota. Consequentemente, suas instâncias podem pular vários números de versão entre as atualizações. Novos lançamentos de janelas de manutenção são anunciados nas notas de lançamento da Apigee.
Janelas de congelamento e exclusão
No momento, a Apigee não oferece suporte a janelas de congelamento ou exclusão de manutenção definidas pelo cliente. Depois que um lançamento é programado, ele prossegue de acordo com a janela configurada e a ordem das configurações de atualização. Modificar ou limpar as configurações de manutenção depois que um evento de manutenção for programado não vai cancelar ou adiar o evento programado.
Práticas recomendadas para janelas de manutenção
Recomendamos definir janelas de manutenção nas instâncias de produção e não definir janelas de manutençã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, a Apigee atualiza todas as instâncias que não têm janelas de manutenção.
- Em seguida, a 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 tempo de lead.
- Se você ativou o recebimento de comunicações sobre eventos de manutenção futuros 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 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 atualizações do sistema primeiro, e poderá usar 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 00h UTC
- Ordem de atualização: Semana 2
As configurações de manutenção de uma instância no ambiente de preparo seriam semelhantes, exceto que a ordem de atualização seria definida como Semana 1. Por fim, nenhuma instância no 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 seja lançada na produção. Se algo der errado no ambiente de desenvolvimento ou preparo, 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. Caso queira definir um filtro de e-mail para notificações, o título do e-mail precisará ser "Próxima manutenção do recurso da Apigee [nome-do-recurso]".
As notificações de manutenção não são enviadas por padrão. Se você quiser receber uma notificação de uma manutenção futura, faça o seguinte:
- Defina uma janela de manutenção.
- Ativar as notificações de manutenção.
- Faça as duas ações 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 terá se inscrito para receber notificações com antecedência suficiente para que o sistema envie uma notificação de manutenção futura.
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 se inscrever em 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 da 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 da 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 sua janela de manutenção como um horário para que a manutenção não seja aplicada nos horários de pico do 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 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 vai fazer 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 nossa frota, às vezes precisamos atualizar sua instância fora dos horários preferenciais. Você não será notificado com antecedência se isso ocorrer, mas os registros de atualização da instância ainda serão gerados para a instância.