Gerenciar plug-ins

Nesta página, descrevemos como visualizar, editar e excluir plug-ins criados usando as extensões de serviço.

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

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

Ver plug-ins

Nesta seção, descrevemos como visualizar plug-ins e versões de plug-ins criados com as 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 as Extensões de Serviço

  2. Clique na guia Plugins.

    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 produto do Google Cloud ao qual 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 associadas ao plug-in.
    • Ú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 por dois-pontos, aparece ao lado do rótulo Filtrar tabela.

    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:

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 do 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 de 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 as Extensões de Serviço

  2. Clique na guia Plugins.

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

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

    • Informações básicas: essa seção mostra detalhes básicos sobre o plug-in, incluindo o produto do Google Cloud ao qual o plug-in 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 do plug-in, os carimbos de data/hora de criação e modificação do plug-in, o tamanho do plug-in, os rótulos e, se a geração de registros estiver ativada, a taxa de amostragem de registros e o nível mínimo de geração de registros.

    • 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 do plug-in ou da imagem e dos resumos relacionados.

      Clique no URL da imagem para ver 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 tiver sido 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

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

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 as Extensões de Serviço

  2. Clique na guia Plugins.

  3. No plug-in que você quer editar, clique em Mais ações e, em seguida, 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 é editável. Você pode editar outros detalhes.

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

    Para mais 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

É possível 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 as Extensões de Serviço

  2. Clique na guia Plugins.

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

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 as Extensões de Serviço

  2. Clique na guia Plugins.

  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, é possível 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 para 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.

Excluir plug-ins

Nesta seção, descrevemos como excluir plug-ins e versões de plug-ins criados com 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 as Extensões de Serviço

  2. Clique na guia Plugins.

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

    Se preferir, 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 esse plug-in, primeiro modifique a extensão para remover o plug-in ou exclua a extensão.

  4. Na caixa de mensagem de confirmação, confirme a operação clicando em Excluir.

gcloud

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

    Para mais informações, saiba como configurar os plug-ins de rota e tráfego do Cloud Load Balancing, além dos plug-ins do 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 exclui 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 as Extensões de Serviço

  2. Clique na guia Plugins.

  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), ela só poderá ser excluída depois que você definir outra versão como a principal.

A seguir