Registrando um recurso como instância de AWS Cloud Map serviço - AWS Cloud Map

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á.

Registrando um recurso como instância de AWS Cloud Map serviço

Você pode registrar os recursos do seu aplicativo como instâncias em um AWS Cloud Map serviço. Por exemplo, suponha que você tenha criado um serviço chamado users para todos os recursos do aplicativo que gerenciam dados do usuário. Em seguida, você pode registrar uma tabela do DynamoDB usada para armazenar dados do usuário como uma instância nesse serviço.

nota

Os seguintes recursos não estão disponíveis no AWS Cloud Map console:

  • Ao registrar uma instância de serviço usando o console, você não pode criar um registro de alias que encaminhe o tráfego para um balanceador de carga do Elastic Load Balancing ELB (). Ao registrar uma instância, você deve incluir o atributo AWS_ALIAS_DNS_NAME. Para obter mais informações, consulte RegisterInstancena AWS Cloud Map APIReferência.

  • Se você registrar uma instância usando um serviço que inclua uma verificação de integridade personalizada, não será possível especificar o status inicial da verificação de integridade personalizada. Por padrão, o status inicial de verificações de integridade personalizadas é Healthy (Íntegra). Para que o status de integridade inicial seja Unhealthy (Não íntegra), registre a instância de forma programática e inclua o atributo AWS_INIT_HEALTH_STATUS. Para obter mais informações, consulte RegisterInstancena AWS Cloud Map APIReferência.

Para registrar uma instância em um serviço, siga estas etapas.

AWS Management Console
  1. Faça login no AWS Management Console e abra o AWS Cloud Map console em https://console.aws.amazon.com/cloudmap/.

  2. No painel de navegação, escolha Namespaces.

  3. Na página Namespaces, escolha o namespace que contém o serviço que você deseja usar como modelo para registrar uma instância do serviço.

  4. No namespace: namespace-namepágina, escolha o serviço que você deseja usar.

  5. Sobre o serviço: service-namepágina, escolha Registrar instância de serviço.

  6. Na página Registrar instância do serviço, escolha um tipo de instância. Dependendo da configuração de descoberta da instância de namespace, você pode optar por especificar um endereço IP, um ID de EC2 instância da Amazon ou outras informações de identificação para um recurso que não tem um endereço IP.

    nota

    Você pode escolher a EC2instância somente em HTTP namespaces.

  7. Para ID da instância de serviço, forneça um identificador associado à instância de serviço.

    nota

    Se você quiser atualizar uma instância existente, forneça o identificador associado à instância que você deseja atualizar. Em seguida, use as próximas etapas para atualizar os valores e registrar novamente a instância.

  8. Com base no tipo de instância de sua escolha, execute as etapas a seguir.

    Tipo de instância Etapas

    Endereço IP

    1. Em Atributos padrão, para IPv4endereço, forneça um IPv4 endereço, se houver, em que seu aplicativo possa acessar o recurso associado a essa instância de serviço.

    2. Para IPv6endereço, forneça um endereço IPv6 IP, se houver, em que seus aplicativos possam acessar o recurso associado a essa instância de serviço.

    3. Para Port, especifique qualquer porta que seu aplicativo deve incluir para acessar o recurso associado a essa instância de serviço. A porta é necessária quando o serviço inclui um SRV registro ou uma verificação de saúde do Amazon Route 53.

    4. (Opcional) Em Atributos personalizados, especifique os pares de valores-chave que você deseja associar ao recurso.

    EC2instância
    1. EC2Por ID da instância, selecione a ID da EC2 instância da Amazon que você deseja registrar como uma instância AWS Cloud Map de serviço.

    2. (Opcional) Em Atributos personalizados, especifique os pares de valores-chave que você deseja associar ao recurso.

    Identifying information for another resource (Identificar informações de outro recurso)
    1. Em Atributos padrão, se a configuração do serviço incluir um CNAMEDNSregistro, você verá um CNAMEcampo. Para CNAME, especifique o nome de domínio que você deseja que o Route 53 retorne em resposta às DNS consultas (por exemplo,example.com).

    2. Em Atributos personalizados, especifique qualquer informação de identificação de um recurso que não seja um endereço IP ou uma ID de EC2 instância da Amazon como um par de valores-chave. Por exemplo, você pode registrar uma função Lambda especificando uma chave chamada function e fornecendo o nome da função Lambda como um valor. Você também pode especificar uma chave chamada name e fornecer um nome que você pode usar para a descoberta programática de instâncias.

  9. Escolha Registrar instância de serviço.

AWS CLI
  • Quando você envia uma solicitação de RegisterInstance:

    • Para cada DNS registro que você define no serviço especificado porServiceId, um registro é criado ou atualizado na zona hospedada associada ao namespace correspondente.

    • Caso o serviço inclua HealthCheckConfig, uma verificação de integridade será criada com base nas configurações da verificação de integridade.

    • Todas as verificações de integridade estão associadas a um dos registros novos ou atualizados.

    Registre uma instância de serviço com o register-instance comando (substitua o red valores com os seus).

    aws servicediscovery register-instance \ --service-id srv-xxxxxxxxx \ --instance-id myservice-xx \ --attributes=AWS_INSTANCE_IPV4=172.2.1.3,AWS_INSTANCE_PORT=808
AWS SDK for Python (Boto3)
  1. Caso ainda não tenha instalado Boto3, é possível encontrar instruções para instalação, configuração e uso do Boto3 aqui.

  2. Importe Boto3 e use servicediscovery como seu serviço.

    import boto3 client = boto3.client('servicediscovery')
  3. Quando você envia uma solicitação de RegisterInstance:

    • Para cada DNS registro que você define no serviço especificado porServiceId, um registro é criado ou atualizado na zona hospedada associada ao namespace correspondente.

    • Caso o serviço inclua HealthCheckConfig, uma verificação de integridade será criada com base nas configurações da verificação de integridade.

    • Todas as verificações de integridade estão associadas a um dos registros novos ou atualizados.

    Registre uma instância de serviço com register_instance() (substitua o red valores com os seus).

    response = client.register_instance( Attributes={ 'AWS_INSTANCE_IPV4': '172.2.1.3', 'AWS_INSTANCE_PORT': '808', }, InstanceId='myservice-xx', ServiceId='srv-xxxxxxxxx', ) # If you want to see the response print(response)

    Exemplo de objeto de resposta

    { 'OperationId': '4yejorelbukcjzpnr6tlmrghsjwpngf4-k95yg2u7', 'ResponseMetadata': { '...': '...', }, }