Como criar uma instância de VM com um nome de host personalizado

Ao criar uma instância de VM, o Google Cloud cria um nome de DNS interno a partir do nome da instância. A menos que você especifique um nome de host personalizado, o Google Cloud usará o nome de DNS interno criado automaticamente como o nome do host fornecido para a VM.

Para criar uma VM com um nome de host personalizado, especifique qualquer nome de DNS totalmente qualificado. Os nomes de host personalizados são úteis para manter convenções ou permitir a compatibilidade com requisitos de aplicativos que aceitam um nome de host específico.

Limitações

  • Você precisa configurar manualmente o registro DNS com o nome de host personalizado. Os nomes de host personalizados não são resolvidos por registros criados automaticamente pelo DNS interno do Compute Engine. Use um dos itens a seguir para hospedar o registro DNS do nome de host personalizado:

  • Após criar a VM, não é possível alterar um nome de host personalizado.

  • Mesmo ao especificar um nome de host personalizado, o Google Cloud ainda cria o nome de DNS interno do Compute Engine. Use esse registro DNS criado automaticamente para estabelecer contato com a VM.

Requisitos

O nome do host precisa estar em conformidade com os requisitos do RFC 1035 (em inglês) para nomes de host válidos. Para atender a esses requisitos, é necessário que os nomes de host contenham uma série de rótulos correspondentes à expressão regular [a-z]([-a-z0-9]*[a-z0-9])?, sendo que todos os rótulos precisam estar concatenados com um ponto. Cada rótulo pode ter de 1 a 63 caracteres, e a sequência inteira não pode exceder 253 caracteres.

Antes de começar

Criar uma VM com um nome de host personalizado

Console

  1. No Console do Google Cloud, acesse a página Criar instância.

    Acessar a página "Criar instância"

  2. Expanda a seção Gerenciamento, segurança, discos, rede, locatário único.
  3. Em Nome do host, na guia Rede, defina o nome de host personalizado.
  4. Continue o processo de criação da instância.

gcloud

Usando a ferramenta de linha de comando gcloud, siga as instruções para criar uma instância a partir de uma imagem ou de um snapshot, adicione a sinalização --hostname e use o comando gcloud compute instances create da seguinte maneira:

gcloud compute instances create instance-name \
    --hostname=hostname

Substitua as seguintes informações:

  • instance-name: o nome da instância
  • hostname: o nome de host do domínio totalmente qualificado a ser atribuído

Por exemplo, para criar uma instância chamada myinstance com o nome de host personalizado test.example.com, execute o comando a seguir:

gcloud compute instances create myinstance \
    --hostname=test.example.com

API

Siga as instruções da API para criar uma instância a partir de uma imagem ou de um snapshot e especifique o campo hostname no corpo da solicitação.

POST https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instances

{
 "name": "instance-name",
 "hostname": "hostname",
 ...
}

Substitua as seguintes informações:

  • project-id: o ID do projeto
  • instance-name: o nome da instância
  • hostname: o nome de host do domínio totalmente qualificado a ser atribuído
  • zone: a zona em que você quer criar a instância

Como verificar o nome de host personalizado

Para instâncias de VM do Linux, execute o comando hostname -f na instância de VM para verificar o nome de host.

Também é possível verificar o nome de host personalizado usando o Console do Google Cloud ou a ferramenta de linha de comando gcloud.

Console

  1. Para ver o nome de host personalizado da instância, acesse a página Instâncias de VM.

    Acessar a página "Instâncias de VM"

  2. Clique no nome da instância para abrir a página Detalhes da instância de VM.
  3. Revise a seção Nome do host. O campo Nome do host será exibido somente se um nome de host personalizado estiver definido.

    Captura de tela da página

gcloud

Para ver o nome de host personalizado da instância por meio de gcloud compute, use o subcomando instances describe com uma sinalização --format para filtrar a saída. Substitua instance-name pelo nome da instância.

gcloud compute instances describe instance-name \
    --format='get(hostname)'

Por exemplo, para ver o nome de host personalizado de uma instância chamada myinstance, execute o comando a seguir.

gcloud compute instances describe myinstance \
    --format='get(hostname)'

A saída pode ser semelhante a esta:

test.example.com

Se um nome de host personalizado não estiver definido, a saída desse comando ficará em branco.

A seguir

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Documentação do Compute Engine