Use mapas de URLs

Este guia mostra como configurar Trusted Cloud mapas de URLs. Um mapa de URLs é um conjunto de regras para encaminhar pedidos HTTP(S) recebidos para serviços de back-end específicos. Um mapa de URLs mínimo corresponde a todos os caminhos de pedidos recebidos (/*).

Antes de seguir este guia, familiarize-se com os conceitos do mapa de URLs.

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

Os mapas de URLs usados com balanceadores de carga de aplicações externos regionais e balanceadores de carga de aplicações internos regionais também suportam várias funcionalidades de gestão de tráfego avançadas. Para mais informações, consulte o artigo Conceitos do mapa de URLs: gestão avançada do tráfego.

Predefinições do mapa de URLs

Os mapas de URLs têm dois valores predefinidos, conforme descrito na tabela seguinte.

Tipo predefinido Definição Significado
Predefinição do mapa de URLs gcloud compute url-maps create

--default-service

 O serviço de back-end predefinido especificado é usado se nenhuma das regras de anfitrião ou dos correspondentes de caminho corresponder ao URL recebido.
Predefinição do localizador de caminhos gcloud compute url-maps add-path-matcher

--default-service

 O serviço de back-end predefinido especificado é usado se o caminho do URL corresponder a um matcher de caminho, mas nenhum dos --path-rules especificados corresponder.

Regras de anfitrião

Uma regra de anfitrião define um conjunto de anfitriões para fazer a correspondência com os pedidos.

Numa regra de anfitrião, o nome do anfitrião tem de ser um nome de domínio totalmente qualificado (FQDN). O nome do anfitrião 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

Configure mapas de URLs

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

Consola

Para adicionar um mapa de URLs através da consola Trusted Cloud , siga os passos seguintes:

  1. Aceda à página Equilíbrio de carga.

    Aceda a Balanceamento de carga

  2. Clique no Nome de um balanceador de carga.
  3. Na página Detalhes do equilibrador de carga, clique em Editar para o equilibrador de carga selecionado.
  4. Selecione Regras de anfitriões e caminhos.
  5. Clique em Adicionar regra de anfitrião e caminho.

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

    1. Introduza um nome de anfitrião totalmente qualificado, por exemplo, web.example.com.
    2. Introduza o caminho, por exemplo, /video.
    3. Na página Regras de anfitrião e caminho, no menu Back-ends, selecione um serviço de back-end disponível.

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

gcloud

Para adicionar um mapa de URLs através da 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 aplicações externos regionais e balanceadores de carga de aplicações internos, certifique-se de que inclui a flag --region quando criar o mapa de URLs.

Para criar um correspondente 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"]

Este comando requer um serviço de back-end predefinido para o qual possa enviar pedidos não correspondentes. A flag --path-rules define mapeamentos entre caminhos de pedidos e serviços de back-end. O exemplo seguinte encaminha os caminhos de pedido /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 anfitrião, 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 corresponde a pedidos em relação a www.example.com e a qualquer subdomínio de altostrat.com:

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

Para alterar o serviço predefinido 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
}

Liste mapas de URLs

Consola

Não pode listar todos os seus mapas de URLs na Trusted Cloud consola.

gcloud

Para apresentar uma lista de mapeamentos de URLs através da CLI Google Cloud, use o comando url-maps list.

gcloud compute url-maps list

Obtenha informações sobre um mapa de URLs

Consola

Para obter informações sobre um mapa de URLs, siga estes passos:

  1. Aceda à página Equilíbrio de carga.

    Aceda a Balanceamento de carga

  2. Clique no Nome de um balanceador de carga.
  3. Na página Detalhes do equilibrador de carga, clique em Editar para o equilibrador de carga selecionado.
  4. Veja as Regras de anfitriões e caminhos.

gcloud

Para obter informações sobre um único mapa de URLs através da Google Cloud CLI, use o comando url-maps describe.

gcloud compute url-maps describe URL_MAP_NAME

Elimine um mapa de URLs

Só pode eliminar um mapa de URLs depois de eliminar todos os proxies de destino que fazem referência ao mesmo. Para mais informações, consulte o artigo Eliminar um proxy de destino.

Consola

Para eliminar um mapa de URLs, siga estes passos:

  1. Aceda à página Equilíbrio de carga.

    Aceda a Balanceamento de carga

  2. Clique no Nome de um balanceador de carga.
  3. Na página Detalhes do equilibrador de carga, clique em Editar para o equilibrador de carga selecionado.
  4. Na página Detalhes do equilibrador de carga, veja as Regras de anfitrião e caminho.
  5. Clique no "X" à direita de um mapa de URLs para o eliminar. O mapa de URLs desaparece.
  6. Procure a marca de verificação azul à esquerda de Regras de anfitrião e caminho e clique no botão Atualizar.

gcloud

Para eliminar um mapa de URLs através da Google Cloud CLI, use o comando url-maps delete. Antes de poder eliminar um mapa de URLs, tem de eliminar todos os proxies HTTP de destino que referenciam o mapa de URLs.

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

Elimine um Path Matcher

Consola

Para eliminar um correspondente de caminho, siga estes passos:

  1. Aceda à página Equilíbrio de carga.

    Aceda a Balanceamento de carga

  2. Clique no Nome de um balanceador de carga.
  3. Na página Detalhes do equilibrador de carga, clique em Editar para o equilibrador de carga selecionado.
  4. Selecione Regras de anfitriões e caminhos.
  5. No campo Caminhos de um mapa de URLs existente, clique no "x" no nome do correspondente de caminhos.
  6. Procure a marca de verificação azul à esquerda de Regras de anfitrião e caminho e clique no botão Atualizar.

gcloud

Para eliminar um correspondente 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]

Elimine uma regra de anfitrião

Consola

Para eliminar uma regra de anfitrião, siga estes passos:

  1. Se ainda não estiver na página Regras de anfitrião e caminho, aceda à página Equilíbrio de carga.

    Aceda a Balanceamento de carga

  2. Clique no Nome de um balanceador de carga.
  3. Na página Detalhes do equilibrador de carga, clique em Editar para o equilibrador de carga selecionado.
  4. Selecione Regras de anfitriões e caminhos.
  5. No campo Anfitriões de um mapeamento de URL existente, clique no "x" no nome do anfitrião.
  6. Procure a marca de verificação azul à esquerda de Regras de anfitrião e caminho e clique no botão Atualizar.

gcloud

Para eliminar uma regra de anfitrião do mapa de URLs, 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 anfitrião que contenha o anfitrião altostrat.com de um mapa de URLs denominado my-map, executaria o seguinte comando:

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

Guias de gestão de tráfego

Nem todas as funcionalidades do mapa de URLs estão disponíveis para todos os produtos. Os mapas de URLs são usados com balanceadores de carga para suportar várias funcionalidades avançadas de gestão de tráfego.

Use a tabela seguinte para saber mais sobre as funcionalidades do mapa de URLs para gestão de obras.

Produto Funcionalidades do mapa de URLs e guias de gestão de tráfego
Balanceador de carga de aplicações externo regional Funcionalidades do balanceador de carga: encaminhamento e gestão de tráfego

Vista geral da gestão de tráfego

Configurar a gestão de tráfego

Configurar um redirecionamento de URL

Configurar um redirecionamento de HTTP para HTTPS

Nome do anfitrião e caminho

Pedidos de planeamento de trajeto

Cookies
Balanceador de carga de aplicações interno Funcionalidades do balanceador de carga: encaminhamento e gestão de tráfego

Vista geral da gestão de tráfego

Configurar a gestão de tráfego

Configurar redirecionamentos de URL

Configurar redirecionamentos de HTTP para HTTPS

Cookies

Nome do anfitrião e caminho

Referência da API e da CLI gcloud

Além da Trusted Cloud consola, pode usar a API e a CLI gcloud para criar mapas de URLs.

API

Para ver descrições das propriedades e dos métodos disponíveis quando trabalha com mapas de URLs através da API REST, consulte o seguinte:

Produto Documentação da API
Balanceador de carga de aplicações externo urlMaps
Balanceador de carga de aplicações interno regionUrlMaps

CLI gcloud

Para a CLI do Google Cloud na CLI do Google Cloud, consulte o seguinte:

  • Regional: --region=[REGION]

Para uma gestão avançada do tráfego, use ficheiros YAML e importe-os com o comando gcloud compute url-maps import.

O que se segue?