Gerenciar plug-ins

Esta página descreve como visualizar, editar e excluir plug-ins criados com as extensões de serviço.

O recurso de plug-ins está em pré-lançamento para a Media CDN.

Para uma visão geral do produto, consulte Visão geral das extensões de serviço.

Ver plug-ins

Esta seção descreve como visualizar plug-ins e versões de plug-ins criados usando extensões de serviço.

Listar plug-ins

Para listar os plug-ins no seu projeto, siga estas etapas:

Console

1. No console do Google Cloud , acesse a página Extensões de serviço.

   Acessar Extensões de serviço

2. Clique na guia Plug-ins.

   Uma lista dos plug-ins aparece em uma tabela classificável com as seguintes informações:

   • Status: o status do plug-in. Se um serviço não estiver anexado, o valor será Not attached. Se um serviço estiver anexado a um plug-in, o valor será Attached.
   • Nome: o nome do plug-in.
   • Versão principal: a versão ativa do plug-in.
   • Produto: o Google Cloud produto a que o plug-in está anexado.
   • Tipo: o tipo de extensão.
   • Escopo: o escopo do plug-in.
   • Região: a região quando o escopo do plug-in é Regional.
   • Em uso por: uma ou mais extensões a que o plug-in está associado.
   • Última modificação: o horário em que o plug-in foi modificado pela última vez.
   • Rótulos: os rótulos adicionados ao plug-in.

3. Opcional: para filtrar a lista, faça o seguinte:

   1. Clique ao lado de Filtrar tabela para ver uma lista de propriedades.

   2. Na lista, selecione uma propriedade.

      O nome da propriedade, seguido de dois-pontos, aparece ao lado do rótulo Tabela de filtros.

   3. Insira um espaço ao lado dos dois-pontos para ver uma lista de valores que correspondem à propriedade e selecione um valor na lista.

   4. Opcional: insira o operador OR entre pares de propriedade-valor para especificar filtros combinados.

4. Opcional: para realizar outras operações com um plug-in selecionado, clique em Mais ações e selecione uma opção:

   • Para editar o plug-in, clique em Editar.
   • Para excluir o plug-in, clique em Excluir.
   • Para abrir a Análise de registros, que pode ser usada para recuperar, visualizar e analisar dados de registros sobre o plug-in, clique em Ver na Análise de registros.
   • Para abrir a página Monitoramento de extensões de serviço, clique em Ver monitoramento.

gcloud

Execute o gcloud service-extensions wasm-plugins listcomando:

gcloud service-extensions wasm-plugins list \
    --location=LOCATION

Substitua LOCATION pelo local do plug-in como global ou uma região.

Os plug-ins no seu projeto são listados em uma tabela com as seguintes informações:

• Nome: o nome do plug-in.
• Descrição: a descrição do plug-in
• Versão principal: a versão ativa do plug-in
• Horário da atualização: o horário em que o plug-in foi modificado pela última vez.

Ver os detalhes de um plug-in

Para conferir os detalhes de um plug-in, use um dos seguintes métodos:

Console

1. No console do Google Cloud , acesse a página Extensões de serviço.

   Acessar Extensões de serviço

2. Clique na guia Plug-ins.

3. Clique no nome do plug-in para conferir os detalhes.

   A página Detalhes do plug-in é aberta. A página tem as seguintes seções:

   • Informações básicas: esta seção mostra detalhes básicos sobre o plug-in, incluindo o produto Google Cloud a que ele está anexado, o tipo de balanceador de carga, o tipo de extensão, as extensões que estão usando o plug-in, o escopo dele, os carimbos de data/hora de criação e modificação, o tamanho, os rótulos e, se o registro em log estiver ativado, a taxa de amostragem de registros e o nível mínimo de registro em log.

   • Versões: esta seção mostra detalhes sobre as versões do plug-in, incluindo a versão do plug-in, o carimbo de data/hora de criação, qualquer descrição especificada, o URI e os resumos da imagem, além do arquivo de configuração ou imagem do plug-in e os resumos relacionados.

     Clique no URL da imagem para conferir os detalhes.

gcloud

Para ver os detalhes de um plug-in, execute o comando gcloud service-extensions wasm-plugins describe:

 gcloud service-extensions wasm-plugins describe WASM_PLUGIN \
     --location=LOCATION

Substitua:

• WASM_PLUGIN: o nome do plug-in
• LOCATION: o local do plug-in como global ou uma região

Os seguintes detalhes sobre o plug-in são mostrados:

• O nome do plug-in
• Os carimbos de data/hora de criação e modificação do plug-in.
• Os rótulos
• A taxa de amostragem de registros (se a geração de registros estiver ativada)

Para listar as versões de um plug-in, use o comando gcloud service-extensions wasm-plugin-versions list:

 gcloud service-extensions wasm-plugin-versions list WASM_PLUGIN \
     --location=LOCATION

Substitua:

• WASM_PLUGIN: o nome do plug-in
• LOCATION: o local do plug-in como global ou uma região

As versões do plug-in especificado são listadas em uma tabela com o nome do plug-in.

Para conferir os detalhes de uma versão do plug-in, use o comando gcloud service-extensions wasm-plugin-versions describe:

 gcloud service-extensions wasm-plugin-versions describe WASM_PLUGIN_VERSION \
     --location=LOCATION

Substitua:

• WASM_PLUGIN_VERSION: a versão principal do plug-in
• LOCATION: o local do plug-in como global ou uma região

Os seguintes detalhes sobre a versão do plug-in são mostrados:

• O nome da versão
• O carimbo de data/hora da criação
• Uma descrição, se ela foi inserida
• O URI e os resumos da imagem
• O arquivo de configuração ou a imagem do plug-in e os resumos relacionados

Editar plug-ins

Esta seção descreve como editar plug-ins criados usando Service Extensions.

Editar um plug-in

Para editar um plug-in, siga estas etapas:

Console

1. No console do Google Cloud , acesse a página Extensões de serviço.

   Acessar Extensões de serviço

2. Clique na guia Plug-ins.

3. No plug-in que você quer editar, clique em Mais ações e selecione Editar.

   Como alternativa, clique no nome do plug-in e, na página Detalhes, clique em Editar.

   Na página Editar plug-in, o nome do plug-in não pode ser editado. Você pode editar outros detalhes.

4. Faça as mudanças necessárias.

   Para informações sobre a maioria dos campos, consulte Criar um plug-in.

   Para informações sobre a seção Versões, consulte Adicionar uma nova versão de um plug-in.

5. Clique em Atualizar plug-in.

gcloud

Execute o comando gcloud service-extensions wasm-plugins update:

gcloud service-extensions wasm-plugins update WASM_PLUGIN \
   --location=LOCATION \
   --description=PLUGIN_DESCRIPTION \
   --labels=[LABELS,...]

Substitua:

• WASM_PLUGIN: o nome do plug-in
• LOCATION: o local do plug-in como global ou uma região
• PLUGIN_DESCRIPTION: a descrição do plug-in
• LABELS: rótulos na forma de pares de chave-valor separados por vírgulas

Adicionar uma nova versão de um plug-in

Você pode criar uma nova versão do código do plug-in e adicioná-la como uma nova versão do plug-in.

Para adicionar uma nova versão de um plug-in, siga estas etapas:

Console

1. No console do Google Cloud , acesse a página Extensões de serviço.

   Acessar Extensões de serviço

2. Clique na guia Plug-ins.

3. Clique em Editar.

4. Na seção Versões, clique em Adicionar versão.

5. No painel Adicionar versão, especifique os detalhes da versão do plug-in.

6. Opcional: marque a caixa de seleção Definir como principal.

   Também é possível definir essa versão como a principal mais tarde.

7. Clique em Adicionar.

8. Clique em Atualizar plug-in.

gcloud

Execute o comando gcloud service-extensions wasm-plugins update:

 gcloud service-extensions wasm-plugins update WASM_PLUGIN \
     --location=LOCATION \
     --image=IMAGE \
     --main-version=MAIN_VERSION \
     --plugin-config=PLUGIN_CONFIG | --plugin-config-file=PLUGIN_CONFIG_FILE | --plugin-config-uri=PLUGIN_CONFIG_URI

Substitua:

• WASM_PLUGIN: o ID ou o nome totalmente qualificado do plug-in.
• LOCATION: o local do plug-in como global ou uma região
• IMAGE: o URI do novo módulo Wasm armazenado no repositório do Artifact Registry
• MAIN_VERSION: o ID da versão do plug-in a ser criada e definida como a versão principal (ou de exibição).
• PLUGIN_CONFIG, PLUGIN_CONFIG_FILE ou PLUGIN_CONFIG_URI: o arquivo de configuração opcional, que pode ser especificado inline como texto, como um arquivo local ou como uma imagem no Artifact Registry, respectivamente.

Observação: para criar uma nova versão do plug-in sem defini-la como a principal, use o comando gcloud service-extensions wasm-plugins create.

Mudar a versão principal de um plug-in

Para mudar a versão principal de um plug-in, siga estas etapas:

Console

1. No console do Google Cloud , acesse a página Extensões de serviço.

   Acessar Extensões de serviço

2. Clique na guia Plug-ins.

3. Clique no botão Editar.

4. Na seção Versões, selecione uma versão inativa e clique em Definir como principal.

   Como alternativa, ao criar uma nova versão do plug-in, você pode definir a versão como a principal.

5. Clique em Atualizar plug-in.

gcloud

Execute o comando gcloud service-extensions wasm-plugins update:

 gcloud service-extensions wasm-plugins update \
     --location=LOCATION \
     --main-version=WASM_PLUGIN_VERSION

Substitua:

• LOCATION: o local do plug-in como global ou uma região
• WASM_PLUGIN_VERSION: o nome da versão principal do plug-in

Pode levar alguns minutos para que a nova versão do plug-in seja distribuída em todos os locais. O número de minutos pode variar de acordo com o local porque o plug-in não é entregue a todos os locais simultaneamente.

Observação: para reverter um plug-in, defina uma versão anterior como a principal.

Excluir plug-ins

Nesta seção, descrevemos como excluir plug-ins e versões de plug-ins criados usando as extensões de serviço.

Excluir um plug-in

Para excluir um plug-in, siga estas etapas:

Console

1. Acesse a página Extensões de serviço.

   Acessar Extensões de serviço

2. Clique na guia Plug-ins.

3. No plug-in que você quer excluir, clique no botão Mais ações e selecione Excluir.

   Como alternativa, clique no nome do plug-in e, em seguida, no botão Excluir na página Detalhes.

   Não é possível excluir plug-ins que estão sendo usados por uma extensão. Para excluir um plug-in desse tipo, primeiro modifique a extensão para remover o plug-in ou exclua a extensão.

4. Na caixa de mensagem de confirmação, clique em Excluir para confirmar a operação.

gcloud

1. Remova as referências ao plug-in da configuração de serviço e reimporte o arquivo YAML de configuração.

   Para mais informações, consulte como configurar os plug-ins de rota e tráfego do Cloud Load Balancing e os plug-ins da Media CDN.

2. Execute o comando gcloud service-extensions wasm-plugins delete:

   gcloud service-extensions wasm-plugins delete WASM_PLUGIN \
       --location=LOCATION
   

   Substitua:

   • WASM_PLUGIN: o nome do plug-in
   • LOCATION: o local do plug-in como global ou uma região

A exclusão de um plug-in também remove os recursos relacionados.

Excluir uma versão de um plug-in

Para excluir uma versão de um plug-in, siga estas etapas:

Console

1. No console do Google Cloud , acesse a página Extensões de serviço.

   Acessar Extensões de serviço

2. Clique na guia Plug-ins.

3. Selecione o plug-in que você quer editar e mude para o modo de edição.

4. Na seção Versões, marque as caixas de seleção das versões que você quer excluir e clique em Excluir.

5. Clique em Atualizar plug-in.

gcloud

Execute o gcloud service-extensions wasm-plugin-versions deletecomando:

 gcloud service-extensions wasm-plugin-versions delete WASM_PLUGIN_VERSION \
     --location=LOCATION

Substitua:

• WASM_PLUGIN_VERSION: o nome de uma versão de plug-in que não está sendo usada como a versão principal.
• LOCATION: o local do plug-in como global ou uma região

Se uma versão estiver definida como a principal (ativa), você só poderá excluí-la depois de definir outra versão como a principal.

A seguir

• Saiba como criar plug-ins.
• Consulte a Visão geral das extensões de serviço.