Gerir instâncias

Esta página aplica-se ao Apigee, mas não ao Apigee Hybrid.

Veja a documentação do Apigee Edge.

Uma instância é uma máquina virtual onde o seu projeto de API e os serviços relacionados são armazenados. As instâncias correspondem a regiões. Normalmente, começa com uma única instância e adiciona novas instâncias à medida que a sua organização se expande para mais regiões. Esta secção explica como:

Crie uma nova instância

Para criar uma nova instância, pode usar a API Instances ou a IU do Apigee. Cada instância requer:

  • a sua própria chave de encriptação de disco para a rede. A Apigee recomenda que também crie um anel de chaves separado para a nova instância. Para mais informações, consulte o artigo Acerca das chaves de encriptação do Apigee.
  • Os seus próprios intervalos CIDR /22 e /28 não sobrepostos para a interligação de redes. Não é possível partilhar os intervalos entre instâncias.

Apigee na Cloud Console

Para criar uma nova instância no Apigee na Cloud Console:

  1. Na Google Cloud consola, aceda à página Gestão > Instâncias.

    Aceda a Instâncias

    O painel Instâncias apresenta uma lista das instâncias existentes.

  2. Clique em + Criar. Pode haver um atraso enquanto a IU determina se a sua organização tem as autorizações adequadas para criar uma nova instância.

    É apresentada a página Criar nova instância.

  3. Introduza os detalhes sobre a nova instância nos campos:
    Campo Obrigatória Descrição
    Runtime hosting location Obrigatória Selecione a região na qual quer criar a nova instância. Não pode criar uma nova instância numa região que já tenha uma instância. Para mais informações sobre como trabalhar com várias regiões, consulte o artigo Usar várias regiões.
    Name Obrigatória

    Introduza o ID da nova instância.

    O valor predefinido é o nome da região de alojamento de tempo de execução que selecionou, mas pode alterá-lo para qualquer nome significativo que quiser, desde que siga as regras de nomenclatura:

    • Duração mínima de 2.
    • Comprimento máximo de 32.
    • Use apenas letras minúsculas, números e hífenes (seguindo o padrão /^[a-z0-9\-]+$/).
    • Tem de começar por uma letra; não tem dígitos nem hífenes iniciais.
    • Tem de terminar com um número ou uma letra e não pode ter hífenes no final.
    • Tem de ser exclusivo na sua organização.
    IP range allocation Obrigatória

    Especifique como quer atribuir um intervalo de IPs. Escolha entre estas opções:

    • Automático (recomendado): o Apigee seleciona um intervalo CIDR disponível com um tamanho do prefixo de /22. Não é necessária nenhuma ação da sua parte.
    • Personalizado: em exemplos de utilização avançados, pode ter de especificar exatamente que intervalo de IP quer que o Apigee use. Nestes casos, especifica um intervalo de IP personalizado, que tem de ter um tamanho do prefixo de /22. O intervalo tem de estar disponível como parte de uma ligação privada entre o seu projeto e o Apigee.
    Disk encryption key Obrigatória

    Em Chave de encriptação de disco, escolha uma chave de encriptação gerida pelo cliente. Se já existir uma chave, pode escolhê-la. O assistente apresenta todas as chaves na mesma localização que a região de alojamento de tempo de execução em todos os conjuntos de chaves. Se não existir uma chave ou não quiser usar uma chave existente, pode criar uma nova chave no assistente. Para criar uma chave:

    1. Clique em Criar chave.
    2. Selecione um conjunto de chaves ou, se não existir, ative a opção Criar conjunto de chaves e introduza um nome para o conjunto de chaves e escolha uma localização para o mesmo. Os nomes dos conjuntos de chaves podem conter letras, números, sublinhados (_) e hífenes (-). Não é possível mudar o nome nem eliminar os conjuntos de chaves.
    3. Clique em Continuar.
    4. Crie uma chave. Introduza um nome e um nível de proteção. Tenha em atenção que os nomes das chaves podem conter letras, números, sublinhados (_) e hífenes (-). Não é possível mudar o nome nem eliminar as chaves. Para o nível de proteção, o software é uma boa opção. Este é o predefinição usado pelo Cloud KMS. No entanto, pode alterá-lo se quiser.
    5. Clique em Continuar e reveja as suas seleções.
    6. Clique em Criar.
    7. Clique em Conceder para conceder à conta de serviço autorização para encriptar/desencriptar com a chave selecionada.
    Environments Opcional

    Selecione os ambientes que quer anexar a esta instância. Para o fazer, clique na lista pendente Ambientes e selecione as caixas de verificação junto aos ambientes que quer anexar. Pode fazê-lo para quantos ambientes quiser. Em seguida, clique em OK.

    Tenha em atenção que os ambientes de todas as instâncias contam para o número total de ambientes que pode ter atribuídos. Para mais informações, consulte o artigo Acerca dos ambientes e dos grupos de ambientes.

    A adição de ambientes quando cria uma nova instância é opcional. Se não os adicionar agora, pode usar a API Instances attachment create ou a IU para os adicionar e remover mais tarde. Consulte o artigo Anexe ou remova um ambiente.
    Accepted projects Opcional Clique em Adicionar projeto aceite para selecionar um ou mais projetos do Google Cloud. Os projetos selecionados podem ligar-se de forma privada à associação de serviço da sua instância. Por predefinição, o projeto associado à sua organização do Apigee está incluído nesta lista.
    Enable logging Opcional Clique no botão Ativar registo para ativar os registos de acesso de entrada do Cloud Logging para a instância. Esta funcionalidade permite-lhe ver os registos gerados por gateways de entrada na sua infraestrutura do Apigee, como um Application Load Balancer externo ou um gateway do Anthos, para ajudar na resolução de problemas de chamadas API do Apigee.

    Para mais informações, consulte o artigo Registo de registos de acesso do Apigee
    Filter Opcional Selecione um código de resposta HTTP na caixa código de resposta para atuar como filtro para os registos de acesso de entrada.

    Se quiser incluir todos os registos, independentemente do código de resposta HTTP, selecione None (all HTTP responses).

    Para criar um filtro personalizado, selecione Custom e introduza o filtro no seguinte formato:

    status_code > XX && status code <= YY

    Por exemplo:

    status_code >= 500 && status_code < 504

    Se a sua organização não conseguir criar uma nova instância, contacte a equipa de vendas do Apigee.

  4. Clique em Criar.

    O Apigee inicia uma operação de longa duração que pode demorar 20 minutos ou mais a ser concluída. Quando terminar, a nova instância é apresentada na lista de instâncias na IU Instâncias.

API Apigee

Se o Apigee tiver sido aprovisionado sem interligação de VPCs, consulte o artigo Crie uma instância de tempo de execução nos passos de aprovisionamento sem interligação de VPCs.

Se o Apigee foi aprovisionado com intercâmbio da VPC, consulte o artigo Crie uma instância de tempo de execução nos passos de aprovisionamento do intercâmbio da VPC.

Anexe ou remova ambientes de uma instância

Quando cria um ambiente através da IU do Apigee na Google Cloud consola, tem a opção de atribuir o ambiente a uma instância existente. Para mais informações, consulte o artigo Criar um novo ambiente na IU.

Se não associou o seu ambiente a uma instância durante a criação do ambiente ou quiser remover um ambiente de uma instância, pode seguir estes passos. Para mais informações sobre ambientes e instâncias, consulte o artigo Ambientes e instâncias.

Para anexar ou remover um ambiente de uma instância através do Apigee na consola do Google Cloud:

  1. Na Google Cloud consola, aceda à página Gestão > Instâncias.

    Aceda a Instâncias

  2. Clique na instância que quer editar.

  3. Na página Detalhes da instância, clique em Editar.
  4. Na página Editar instância, clique no campo Ambientes (opcional) e: selecione o ambiente que quer anexar à instância ou desmarque o ambiente que quer remover.
  5. Clique em OK.
  6. Clique em Guardar para guardar as alterações.

Além de usar a IU, também pode anexar ambientes a uma instância através da API de criação de anexos de instâncias. Para ver um exemplo, consulte o artigo Crie um ambiente na documentação de aprovisionamento da linha de comandos.

Edite a lista de projetos aceites

Pode adicionar ou remover projetos da lista Projetos aceites:

  1. Na Google Cloud consola, aceda à página Gestão > Instâncias.

    Aceda a Instâncias

  2. Clique na instância que quer editar.

  3. Na página Detalhes da instância, clique em Editar.
  4. Na secção Projetos aceites da página Editar instância, clique em Eliminar junto a um projeto para o remover. Para adicionar um projeto, clique em Adicionar projeto aceite e introduza o ID do projeto a adicionar.
  5. Clique em Guardar para guardar as alterações.

Ative ou desative os registos de acesso de entrada para uma instância

Depois de criar uma instância, pode ativar e desativar os registos de acesso de entrada do Cloud Logging para a instância:

  1. Na Google Cloud consola, aceda à página Gestão > Instâncias.

    Aceda a Instâncias

  2. Clique na instância que quer editar.

  3. Na página Detalhes da instância, clique em Editar.
  4. Na página Editar instância, clique no botão Ativar registo para desativar a funcionalidade.
  5. Clique em Guardar para guardar as alterações.

Elimine uma instância

Pode usar a IU do Apigee para eliminar uma instância existente, conforme descrito nesta secção. Em alternativa, pode eliminar uma instância através da API Instances.

Só pode ter uma instância do Apigee numa determinada região do Google Cloud. Quando elimina uma instância, esta é completamente removida da respetiva região. Veja também a instalação multirregional.

Aviso: quando elimina uma instância, todos os dados associados a essa instância são perdidos. Não é possível anular este passo. No entanto, se tiver várias instâncias, como numa instalação em várias regiões, os dados só são perdidos se eliminar todas as instâncias. Antes de eliminar a última instância, certifique-se de que extrai e faz uma cópia de segurança de todos os dados que não quer perder.

Os seguintes dados são armazenados numa instância do Apigee e são eliminados se eliminar a instância:

Tipo de dados Descrição
Sistema de gestão de chaves (KMS) Os dados do KMS incluem produtos de API, programadores, apps de programadores, tokens OAuth (incluindo tokens de acesso, tokens de atualização e códigos de autorização) e chaves de API. Use a política AccessEntity ou a API Apigee relacionada para obter os dados que quer guardar.
Mapa de chaves-valores (KVM) Todos os dados que podem ser criados ou geridos com políticas de KVM. Consulte Obter KVMs.
Quota Definições, contentores e contadores de quotas.
Cache do ambiente Todos os dados em cache.

Para eliminar uma instância do Apigee através da IU do Apigee na Google Cloud Console:

  1. Na Google Cloud consola, aceda à página Gestão > Instâncias.

    Aceda a Instâncias

  2. Clique na instância que quer eliminar.
  3. Na página Detalhes da instância, clique em Eliminar.