Usar mapas de URL

Neste guia, mostramos como configurar mapas de URL Trusted Cloud. Um mapa de URL é um conjunto de regras para rotear solicitações recebidas HTTP para serviços de back-end específicos. Um mapa de URL mínimo corresponde a todos os caminhos de solicitação recebida (/*).

Antes de segui-lo, familiarize-se com os conceitos do mapa de URL.

Os mapas de URL são usados com os seguintes produtos do Trusted Cloud :

Os mapas de URLs usados com balanceadores de carga de aplicativo externos regionais e balanceadores de carga de aplicativo internos regionais também são compatíveis com vários recursos avançados de gerenciamento de tráfego. Saiba mais em Conceitos do mapa de URL: gerenciamento avançado de tráfego.

Padrões do mapa de URLs

Os mapas de URLs têm dois padrões, conforme descrito na tabela a seguir.

Tipo padrão Configuração Significado
Padrão do mapa de URL gcloud compute url-maps create

--default-service

 O serviço padrão especificado será usado se nenhuma correspondência de caminho ou regra de host corresponder ao URL de entrada.
Padrão de correspondência de caminho gcloud compute url-maps add-path-matcher

--default-service

 O serviço padrão especificado será usado se o caminho do URL corresponder a uma correspondência de caminho, mas nenhuma das --path-rules especificada.

Regras do host

Uma regra de host define um conjunto de hosts para fazer a correspondência entre as solicitações.

Em uma regra de host, o nome do host precisa ser um nome de domínio totalmente qualificado (FQDN). O nome do host não pode ser um endereço IPv4 ou IPv6. Por exemplo:

  • Funciona: example.com
  • Funciona: web.example.com
  • Funciona: *.example.com
  • Não funciona: 35.244.221.250

Configurar mapas de URL

Um mapa de URLs pode enviar tráfego para serviços de back-end

Console

Para adicionar um mapa de URLs usando o console Trusted Cloud , siga estas etapas:

  1. Acesse a página Balanceamento de carga.

    Acessar o "Balanceamento de carga"

  2. Clique no Nome de um balanceador de carga.
  3. Na página Detalhes do balanceador de carga, clique em Editar no balanceador de carga selecionado.
  4. Selecione Regras de host e caminho.
  5. Clique em Adicionar regra de host e caminho.

  6. Preencha o campo Host, o campo Caminhos ou ambos e selecione um serviço de back-end

    1. Insira um Nome de host totalmente qualificado, como web.example.com.
    2. Digite o caminho, por exemplo, /video.
    3. Na página Regras de host e caminho, do menu Back-ends, selecione um serviçode back-end disponível.

  7. Procure a marca de seleção azul à esquerda de Regras de host e caminho e clique no botão Atualizar.

gcloud

Para adicionar um mapa de URLs usando a Google Cloud CLI, use o comando url-maps create:

gcloud compute url-maps create URL_MAP_NAME \
   (--default-service=DEFAULT_SERVICE) \
   [--description DESCRIPTION] \
   [--region=REGION]

Para balanceadores de carga de aplicativo externos regionais e balanceadores de carga de aplicativo internos, certifique-se de incluir a sinalização --region ao criar o mapa de URL.

Para excluir uma correspondência de caminho, use o comando gcloud compute url-maps add-path-matcher:

gcloud compute url-maps add-path-matcher URL_MAP_NAME \
   (--default-service=DEFAULT_SERVICE) \
   --path-matcher-name PATH_MATCHER \
   [--path-rules="PATH=SERVICE"]

Esse comando requer um serviço de back-end padrão ao qual ele possa enviar solicitações não correspondidas. A flag --path-rules define mapeamentos entre caminhos de solicitação e serviçosde back-end. O exemplo a seguir roteia os caminhos de solicitação /video/ e /video/* para o serviço de back-end video-service:

--path-rules="/video=video-service,/video/*=video-service"

Para criar uma regra de host, use o comando gcloud compute url-maps add-host-rule:

gcloud compute url-maps add-host-rule URL_MAP_NAME \
    --hosts=[HOSTS] --path-matcher-name=PATH_MATCHER

Por exemplo, o valor --hosts a seguir corresponde a solicitações para www.example.com e qualquer subdomínio de altostrat.com:

--hosts=[*.altostrat.com,www.example.com]

Para alterar o serviço padrão de um mapa de URLs, use o comando url-maps set-default-service:

gcloud compute url-maps set-default-service URL_MAP_NAME
  (--default-service=DEFAULT_SERVICE)[GCLOUD_WIDE_FLAG ...]

Terraform

Para criar um mapa de URLs regional, use o recurso google_compute_region_url_map. 

resource "google_compute_region_url_map" "default" {
  name            = "regional-l7-xlb-map"
  region          = "us-west1"
  default_service = google_compute_region_backend_service.default.id
}

Listar mapas de URL

Console

Não é possível listar todos os mapas de URL no console Trusted Cloud .

gcloud

Para exibir uma lista de mapas de URL usando a Google Cloud CLI, use o comando url-maps list.

gcloud compute url-maps list

Receber informações sobre um mapa de URL

Console

Para ver informações sobre um mapa de URLs, execute estas etapas:

  1. Acesse a página Balanceamento de carga.

    Acessar o "Balanceamento de carga"

  2. Clique no Nome de um balanceador de carga.
  3. Na página Detalhes do balanceador de carga, clique em Editar no balanceador de carga selecionado.
  4. Veja as Regras de host e caminho.

gcloud

Para informações sobre um único mapa de URL usando a Google Cloud CLI, use o comando url-maps describe.

gcloud compute url-maps describe URL_MAP_NAME

Excluir um mapa de URL

Só é possível excluir um mapa de URL depois de ter excluído todos os proxies de destino que se referem a ele. Saiba mais em Como excluir um proxy de destino.

Console

Para excluir um mapa de URLs, execute as seguintes etapas:

  1. Acesse a página Balanceamento de carga.

    Acessar o "Balanceamento de carga"

  2. Clique no Nome de um balanceador de carga.
  3. Na página Detalhes do balanceador de carga, clique em Editar no balanceador de carga selecionado.
  4. Na página Detalhes do balanceador de carga, acessa as Regras de host e caminhos.
  5. Clique no "X", à direita de um mapa de URLs para excluí-lo. O mapa de URLs desaparecerá.
  6. Procure a marca de seleção azul à esquerda de Regras de host e caminho e clique no botão Atualizar.

gcloud

Para excluir um mapa de URLs usando a Google Cloud CLI, use o comando url-maps delete. Antes de excluir um mapa de URLs, primeiro é preciso excluir todos os proxies HTTP de destino que fizerem referência ao mapa de URL.

gcloud compute url-maps delete URL_MAP_NAME [--quiet]

Excluir uma correspondência de caminho

Console

Para excluir uma correspondência de caminho, execute as seguintes etapas:

  1. Acesse a página Balanceamento de carga.

    Acessar o "Balanceamento de carga"

  2. Clique no Nome de um balanceador de carga.
  3. Na página Detalhes do balanceador de carga, clique em Editar no balanceador de carga selecionado.
  4. Selecione Regras de host e caminho.
  5. No campo Caminhos, de um mapa de URLs, clique no “x” no nome da correspondência de caminho.
  6. Procure a marca de seleção azul à esquerda de Regras de host e caminho e clique no botão Atualizar.

gcloud

Para excluir uma correspondência de caminho, use o comando gcloud compute url-maps remove-path-matcher:

gcloud compute url-maps remove-path-matcher URL_MAP_NAME \
   [--path-matcher-name PATH_MATCHER]

Excluir uma regra de host

Console

Para excluir uma regra de host, execute as seguintes etapas:

  1. Se você ainda não estiver na página Regras de host e caminho, acesse a página de Balanceamento de carga.

    Acessar o "Balanceamento de carga"

  2. Clique no Nome de um balanceador de carga.
  3. Na página Detalhes do balanceador de carga, clique em Editar no balanceador de carga selecionado.
  4. Selecione Regras de host e caminho.
  5. No campo Hosts de um mapa de URLs, clique no “x” no nome do host.
  6. Procure a marca de seleção azul à esquerda de Regras de host e caminho e clique no botão Atualizar.

gcloud

Para excluir uma regra de host do seu mapa de URL, use o comando gcloud compute url-maps remove-host-rule:

gcloud compute url-maps remove-host-rule URL_MAP_NAME --host=HOST

Por exemplo, para remover uma regra de host que contém o host altostrat.com de um mapa de URL denominado my-map, execute o comando a seguir:

gcloud compute url-maps remove-host-rule my-map --host altostrat.com

Guias de gerenciamento de tráfego

Nem todos os recursos do mapa de URL estão disponíveis para todos os produtos. Os mapas de URL são usados com balanceadores de carga para aceitar vários recursos avançados de gerenciamento de tráfego

Use a tabela a seguir para saber mais sobre os recursos do mapa de URL para trabalhos de gerenciamento.

Produto Recursos de mapa de URL e guias de gerenciamento de tráfego
Balanceador de carga de aplicativo externo regional Recursos do balanceador de carga: roteamento e gerenciamento de tráfego

Visão geral do gerenciamento de tráfego

Como configurar o gerenciamento de tráfego

Como configurar um redirecionamento de URL

Como configurar um redirecionamento HTTP para HTTPS

Nome e caminho do host

Como encaminhar solicitações

Cookies
Balanceador de carga de aplicativo interno Recursos do balanceador de carga: roteamento e gerenciamento de tráfego

Visão geral do gerenciamento de tráfego

Como configurar o gerenciamento de tráfego

Como configurar redirecionamentos de URL

Como configurar redirecionamentos HTTP-HTTPS

Cookies

Nome e caminho do host

Referência da CLI gcloud e da API

Além do console Trusted Cloud , é possível usar a API e a CLI gcloud para criar mapas de URL.

API

Veja descrições das propriedades e dos métodos disponíveis ao trabalhar com mapas de URL por meio da API REST em:

Produto Documentação da API
Balanceador de carga de aplicativo externo urlMaps
Balanceador de carga de aplicativo interno regionUrlMaps

CLI da gcloud

Para a Google Cloud CLI na Google Cloud CLI, consulte:

  • Regional: --region=[REGION]

Para gerenciamento de tráfego avançado, use arquivos YAML e importe-os com o comando gcloud compute url-maps import.

A seguir