Ciclo de vida de uma implantação do marketplace

Neste documento, explicamos como instalar, fazer upgrade e desinstalar pacotes de software do Marketplace do Google Distributed Cloud (GDC) com isolamento físico usando o console do GDC. Também é possível instalar pacotes de software usando a CLI da gdcloud marketplace ou a API Marketplace.

Este documento é destinado a públicos-alvo do grupo de operadores de aplicativos que gerenciam o ciclo de vida das implantações do Marketplace em projetos do GDC. Para mais informações, consulte Públicos-alvo da documentação do GDC com isolamento físico.

Antes de começar

Antes de instalar, fazer upgrade ou desinstalar pacotes de software do Marketplace, você precisa ter as permissões necessárias e preparar seu ambiente.

Solicitar papéis do IAM

Entre em contato com o admin. da organização do IAM ou o administrador do projeto do IAM para solicitar os seguintes papéis com base nas tarefas que você precisa realizar no projeto:

• Editor do Marketplace (marketplace-editor): instalar, fazer upgrade e desinstalar pacotes de software do Marketplace.
• Leitor do projeto (project-viewer): visualizar um projeto atual e os recursos dele.

O administrador da organização do IAM pode conceder esses papéis para qualquer projeto na organização. O administrador do projeto do IAM pode conceder esses papéis no escopo do projeto específico.

Preparar o ambiente

As tarefas nesta página usam principalmente o console do GDC. Se você planeja usar as alternativas de linha de comando, faça o seguinte:

• Faça o download e instale a CLI gdcloud, caso ainda não tenha feito isso.
• Para usar a API com kubectl, é necessário fazer uma configuração adicional:
  • Instale a CLI kubectl.
  • Gere um arquivo kubeconfig.

Instalar um pacote de software do Marketplace do Distributed Cloud

Para instalar um pacote de software do marketplace do Distributed Cloud, siga estas etapas:

Console

1. No seletor de projetos do console do GDC, selecione o projeto em que você quer instalar o pacote de software.
2. No marketplace do Distributed Cloud, acesse a página de listagem do produto que você quer instalar. Nessa página, você pode conferir detalhes do produto e seguir links para a documentação, os preços e os Termos de Serviço.
3. Se esta for a primeira vez que você instala o produto, clique em Instalar. Caso contrário, acesse a guia "Gerenciamento" e clique em Nova instância.
4. Na caixa de diálogo, selecione em qual cluster de usuário você quer instalar o pacote de software. Se quiser personalizar a configuração, clique em Próxima. Se quiser usar a configuração padrão, clique em Instalar.
5. Se você clicou em Próxima, agora pode examinar a configuração padrão. Clique em Configuração personalizada para inserir seus próprios parâmetros, seguindo a documentação do fornecedor. Quando terminar, clique em Instalar para continuar. Para pacotes de software do Kubernetes, os parâmetros configurados aqui substituem os valores padrão fornecidos pelo fornecedor no arquivo de valores do Helm.

6. Aguarde alguns minutos para que a nova instância seja marcada como Pronta na guia Gerenciamento da página.

   

7. Consulte a documentação do fornecedor de software relevante para saber como usar a solução depois de instalada.

gdcloud

1. Selecione o projeto em que você quer instalar o pacote de software:

   gdcloud config set project PROJECT_NAME
   

   Substitua PROJECT_NAME pelo nome do projeto em que você quer instalar o pacote de software.

2. Liste os aplicativos disponíveis do Marketplace:

   gdcloud marketplace services list
   

3. Instale o aplicativo selecionado na lista, especificando o cluster de destino:

   gdcloud marketplace services install SERVICE_NAME \
     --cluster=CLUSTER_NAME
   

   Para fornecer substituições de configuração personalizadas durante a instalação, use a flag --parameters-file:

   gdcloud marketplace services install SERVICE_NAME \
     --cluster=CLUSTER_NAME \
     --parameters-file=PATH_TO_PARAMETERS_FILE
   

   Substitua:

   • SERVICE_NAME: o nome do serviço do Marketplace a ser instalado (por exemplo, dataproc)
   • CLUSTER_NAME: o nome do cluster de usuário de destino em que você quer instalar o aplicativo.
   • PATH_TO_PARAMETERS_FILE: o caminho para um arquivo YAML que contém parâmetros de substituição de configuração para a instância de serviço.

4. Verifique a instalação:

   gdcloud marketplace services list
   

   Confirme se o aplicativo recém-instalado aparece na lista com o status READY ou INSTALLED.

API

1. Liste os recursos ServiceVersion disponíveis para encontrar o serviço e a versão específicos que você quer instalar:

   kubectl get serviceversions -n mkt-system
   

2. Crie um manifesto YAML para um recurso ServiceInstance (por exemplo, service-instance.yaml):

   apiVersion: marketplace.gdc.goog/v1
   kind: ServiceInstance
   metadata:
     name: INSTANCE_NAME
   spec:
     clusterRef:
       name: CLUSTER_NAME
       namespace: CLUSTER_NAMESPACE
     serviceVersionRef:
       name: SERVICE_VERSION_NAME
       namespace: mkt-system
     parameters:
       KEY: VALUE
   

   Substitua:

   • INSTANCE_NAME: um nome para a nova instância do aplicativo.
   • CLUSTER_NAME: o nome do cluster de usuário de destino em que você quer instalar o aplicativo.
   • CLUSTER_NAMESPACE: o namespace do cluster (por exemplo, production-cluster)
   • SERVICE_VERSION_NAME: o nome do ServiceVersion a ser instalado (por exemplo, dataproc-1.0.0)
   • KEY: o nome do parâmetro de substituição da configuração, seguindo o esquema de valores do Helm do fornecedor.
   • VALUE: o valor do parâmetro de substituição da configuração.

   Para mais informações e um exemplo de manifesto, consulte a visão geral da API Marketplace.

3. Aplique o manifesto ao projeto:

   kubectl apply -f service-instance.yaml -n PROJECT_NAME
   

   Substitua PROJECT_NAME pelo nome do projeto em que você quer instalar o pacote de software.

4. Verifique a instalação inspecionando o status do objeto ServiceInstance:

   kubectl get serviceinstance INSTANCE_NAME -n PROJECT_NAME -o yaml
   

   Confirme se status.conditions contém uma condição do tipo Ready com o status "True" e se status.installedVersion exibe a versão instalada.

Observação: se você precisar saber qual imagem do contêiner está disponível no GDC, consulte a lista de imagens do Marketplace incluídas na sua versão do GDC. As imagens incluídas em versões anteriores do GDC permanecem disponíveis para uso, mesmo após um upgrade do GDC.

Reconfigurar uma instância de um pacote de software do marketplace do Distributed Cloud

Aviso :embora seja possível reconfigurar uma instância em execução de um pacote de software do marketplace do Distributed Cloud, o processo de reconfiguração é implementado pelo fornecedor que publicou o produto. Portanto, o processo de reconfiguração varia de um pacote de software para outro. Recomendamos que você leia atentamente a documentação do fornecedor relevante antes de prosseguir com uma reconfiguração. Dependendo de como o fornecedor implementou o processo de reconfiguração, pode haver inatividade no serviço fornecido.

Alguns pacotes de software do marketplace do Distributed Cloud podem ser reconfigurados quando já estão em execução. Para serviços baseados em Kubernetes, isso equivale a aplicar novos valores ao gráfico do Helm do fornecedor.

Para reconfigurar uma instância em execução de um pacote de software do marketplace do Distributed Cloud, siga estas etapas:

1. No seletor de projetos do console do GDC, selecione o projeto em que você quer fazer upgrade do pacote de software.
2. Na página do marketplace do Distributed Cloud, acesse a página de detalhes do produto que você quer atualizar.
3. Clique na guia Gerenciamento.
4. Clique em Arquivo de configuração para a instância que você quer reconfigurar.
5. No painel que abrir, insira os parâmetros personalizados, seguindo a documentação do fornecedor.
6. Clique em Salvar para aplicar os novos parâmetros. A reconfiguração é concluída em alguns minutos.

Fazer upgrade de um pacote de software do marketplace do Distributed Cloud

Aviso: embora seja possível acionar o upgrade de um pacote de software usando o marketplace do Distributed Cloud, o processo de upgrade é implementado pelo fornecedor que publicou o produto. Portanto, o processo de upgrade varia de um pacote de software para outro. Recomendamos que você leia atentamente as notas da versão e a documentação de upgrade do fornecedor relevante antes de prosseguir com um upgrade. Dependendo de como o fornecedor implementou o processo de upgrade, pode haver inatividade no serviço fornecido ou problemas de compatibilidade entre as versões mais antigas e as mais recentes.

Alguns pacotes de software do marketplace do Distributed Cloud podem ser atualizados para uma nova versão pelo marketplace do Google Distributed Cloud depois que o operador de infraestrutura disponibilizar essas novas versões para você.

Para fazer upgrade de um pacote de software do marketplace do Distributed Cloud, siga estas etapas:

1. No seletor de projetos do console do GDC, selecione o projeto em que você quer fazer upgrade do pacote de software.
2. Na página do marketplace do Distributed Cloud, acesse a página de detalhes do produto que você quer atualizar.
3. Clique na guia "Gerenciamento".
4. Clique em Fazer upgrade na instância que você quer atualizar. O upgrade será concluído em alguns minutos.

Observação :o upgrade de um pacote de software pelo console do Distributed Cloud leva à instalação da próxima versão disponível do software. Se houver várias versões novas do software disponíveis, repita o processo para cada uma delas. Se necessário, use a API Marketplace para fazer upgrade para uma versão específica.

Desinstalar um pacote de software do Distributed Cloud Marketplace

Aviso: desinstalar um pacote de software do marketplace do Distributed Cloud é uma ação destrutiva e pode resultar em perda de dados ou inatividade de sistemas que dependem desse software. Antes de continuar, faça backup de todos os dados importantes e verifique se nenhum sistema importante depende do software que você quer desinstalar. Consulte a documentação do fornecedor relevante para saber como fazer backup de todos os dados gerenciados pelo software dele.

Para desinstalar um pacote de software do marketplace do Distributed Cloud, siga estas etapas:

1. No seletor de projetos do console do GDC, selecione o projeto de onde você quer desinstalar o pacote de software.
2. Na página do marketplace do Distributed Cloud, acesse a página de detalhes do produto que você quer desinstalar.
3. Clique na guia Gerenciamento.
4. Clique em Desinstalar na instância que você quer desinstalar. O pacote de software é desinstalado em alguns minutos.