O Lucidscale permite que você importe dados de infraestrutura de nuvem do Google Cloud (antigo GCP) e gere diagramas desses dados em um modelo Lucidscale.

Para saber mais sobre a funcionalidade disponível com uma licença do Lucidscale, consulte nosso artigo Planos do Lucidscale. Para comprar uma licença, consulte nossa página de preços.

Assista: Importe a infraestrutura do Google Cloud

Recursos e linhas suportados

O Lucidscale oferece suporte aos seguintes recursos do Google Cloud :

Bigtable Instances
Big Query Datasets
Cloud DNS
Cloud functions
Cloud Routes
Cloud routers
Compute (Autoscalers, Instances, Instance Groups)
Database (SQL Instances)
Firewalls
GKE Cluster View
Google Kubernetes Engine (Google Cloud Side, not Kubernetes depth)
Interconnect ( Dedicated Interconnects + Partner Interconnects)
IPsec VPN
Manage (Project, Zone)
NAT Gateway
Network (Firewall, Network, Subnetwork)
Node Pools
Persistent disk
Shared VPC View
Storage (Bucket)
VLAN Attachments (interconnectAttachments)
VPN tunnels
VPN Gateways

Podemos traçar linhas entre os recursos que fazem referência explícita a outro nos metadados:

Google Cloud VPC Network Peering [Network → Network]
Instance to Subnetwork (Shared VPC line)

Observação: se você optou por resumir os recursos em uma visualização Lucidscale, será necessário desresumi-los para que as linhas sejam renderizadas no modelo.

Importar infraestrutura do Google Cloud

Você pode importar o Google Cloud Infrastructure usando um dos dois métodos: fornecendo uma conta de serviço do Google Cloud com as políticas adequadas; ou executando um script na sua Interface de Linha de Comando (CLI).

Se você estiver trabalhando com um ambiente muito grande, use as instruções encontradas na seção Configuração do projeto deste artigo para ajudar a reduzir a quantidade de dados que você está importando ou reduzir o número de chamadas de API que o Lucidscale faz para o Google Cloudx. O Data Central suporta até cinco importações simultâneas. Se você quiser importar mais de cinco projetos, precisará esperar um terminar e depois iniciar outro.

Observação: se você importar usando o método de conta de serviço, o Lucidscale salva as contas de serviço no Data Hub para que você possa usá-las no futuro sem precisar inserir novamente as informações da sua conta.

Para renderizar a infraestrutura do Google Cloud em um modelo Lucidscale:

Google-cloud-model-from-página inicial da Lucid.png

Clique em + Novo na página inicial do Lucid.
passe o cursor sobre "Lucidscale".
Selecione o modelo do Google Cloud.
Escolha criar um modelo com um projeto importado anteriormente Google Cloud ou clique em Open Data Central para importar um novo projeto.
Clique em + Novo Projeto e escolha um método de importação.
- Após escolher um método de importação e concluir a importação, o projeto será listado como uma fonte de dados Google Cloud seção "Google Cloud" no Data central. Você também pode encontrá-lo listado como um projeto "importado" Google Cloud no modal após clicar em + Novo > Lucidscale > Google Cloud Model.
Clique no menu de três pontos ao lado da conta da qual você deseja criar um modelo.
No menu, selecione Criar novo modelo.
Revise os detalhes e selecione as visualizações para adicionar apenas os recursos necessários.
Selecione Criar modelo do Google Cloud.

O modelo Lucidscale será gerado em segundo plano na sua conta Lucid. Iremos notificá-lo assim que for processado por meio do modal de status que aparece no canto inferior direito da página.

Você pode abrir o modelo a partir do modal de status que renderiza diretamente após a criação de um novo modelo. O modelo (e os modelos criados anteriormente) também serão armazenados e acessíveis na seção "Documentos" da página inicial do Lucid depois de gerá-lo.

Como

Saiba mais: para saber como trabalhar com a arquitetura do Google Cloud em um modelo Lucidscale depois que ele for renderizado, confira o artigo vinculado.

Importar projetos e criar modelos via conta de serviço (recomendado)

Para importar a infraestrutura do Google Cloud por meio de uma conta de serviço e renderizar um modelo Lucidscale, siga estas etapas:

Na página inicial do Lucid, clique em + Novo.
Passe o cursor sobre Lucidscale.
Selecione o modelo do Google Cloud.
Clique em + Novo projeto.
Selecione Conta de serviço do Google Cloud (recomendado).
Clique em Criar uma nova conta de serviço.
No Lucid, selecione entre as duas opções para atribuir uma função à conta de serviço. Clique no link a seguir que corresponde à seleção que você fez no Lucid:
- Use uma função somente leitura para todos os recursos (recomendado)
- Criar uma função personalizada com permissões mínimas

Etapa 2: atribuir uma função à conta de serviço usando uma função somente leitura para todos os recursos (recomendado)

No próximo modal em “Etapa 1: Criar uma nova conta de serviço”, clique em Criar conta de serviço para abrir uma nova guia e fazer login em sua conta do Google Cloud. Deixe a guia do navegador Lucid aberta para poder retornar a ela conforme necessário.
Certifique-se de que a opção “Usar uma função somente leitura para todos os recursos (recomendado)” esteja selecionada.
No console do Google Cloud , clique em Criar conta de serviço.
Adicione os detalhes da conta de serviço e clique em Criar e continuar.
Clique no menu suspenso “Selecionar uma função”.
Selecione Básico.
Clique em Visualizador.
Clique em Concluído.
Vá para a etapa 3: gere uma chave JSON e adicione a conta de serviço ao Lucidscale.

Etapa 2: atribua uma função à conta de serviço criando uma função personalizada com permissões mínimas

Na guia Lucid, selecione a opção “Criar uma função personalizada com permissões mínimas”.
Clique em Baixar luciscale.yaml para baixar o arquivo yaml para o seu computador.
Selecione a guia Nível da organização ou Nível do projeto dependendo do nível de dados que você deseja visualizar no Lucidscale.
- Neste exemplo, usaremos a opção Project Level.
Copie a linha de código resultante exibida.
Navegue até o console do Google Cloud e faça login.
Clique em Ativar Cloud Shell.
Clique no ícone de três pontos acima do terminal Cloud Shell e selecione Upload.
Navegue até o arquivo yaml baixado anteriormente e carregue-o.
Cole a linha de código copiada (da etapa 4 acima) no terminal e substitua os seguintes valores na linha de código:
- role-id = o valor que você deseja usar para o ID da sua função
- projeto-id = seu ID de projeto Google Cloud
- yaml-file-path = caminho para o .yaml arquivo
- O resultado final deve ser algo como isto (usando valores falsos):
  - funções gcloud iam criar lucidscalerole --project=test-project-id --file=lucidscale.yaml
- Se você estiver usando a linha de código de nível organizacional, o exemplo seria mais ou menos assim (também usando valores falsos):
  - funções gcloud iam criar lucidscalerole --organization=test-organization-id --file=lucidscale.yaml
Clique em Autorizar.
No terminal, você receberá a mensagem “Tem certeza de que deseja fazer esta alteração (S/N)?”. Digite “Y” e clique em Enter.
Continue na Etapa 3: Gere uma chave JSON e adicione a conta de serviço ao Lucidscale abaixo.

Etapa 3: gere uma chave JSON e adicione a conta de serviço ao Lucidscale

No console do Google Cloud , selecione a Conta de Serviço que você criou na etapa 1.8.
Clique na guia “Chaves”.
Selecione Adicionar chave e clique em Criar nova chave.
Escolha JSON como o “tipo de chave”.
Clique em Criar.
Um arquivo JSON será baixado para o seu dispositivo.
Navegue de volta para a guia aberta do navegador Lucid.
Selecione Escolher arquivo.
Localize e selecione para fazer upload do arquivo JSON que você baixou na etapa 6.
Clique em Avançar.

Etapa 4: adicionar projetos e criar modelos

Selecione o(s) projeto(s) que deseja importar para o Data Central e use para gerar um modelo Lucidscale.
Clique em Avançar.
Selecione os recursos para importar.
Selecione Importar projeto Google Cloud .

Saiba mais: para saber como trabalhar com a arquitetura do Google Cloud em um modelo Lucidscale depois que ele for renderizado, confira o artigo vinculado.

Configuração do projeto usando uma conta de serviço

Ao importar um projeto Google Cloud para o Lucid Data central usando o método de conta de serviço, você pode omitir tipos de recursos ou metadados escolhidos da importação. Isso lhe dá a capacidade de visualizar apenas os tipos de recursos nos quais você está interessado e, em alguns casos, pode aumentar a velocidade da importação. Tipos de recursos e metadados desmarcados não serão importados ou renderizados no diagrama.

Google-cloud-lucidscale-projeto-selecionar-recursos-para-importar.png

Importar projeto e criar modelos via Google Cloud CLI

Instale o Python se você ainda não o tiver. As instruções podem ser encontradas aqui. Certifique-se de marcar a opção “Adicionar Python ao PATH” no instalador. Você pode verificar se o Python foi instalado corretamente testando os comandos “python” ou “python 3” em um terminal (MAC OS) ou prompt de comando (Windows).

Na página inicial do Lucid, clique em + Novo.
Passe o cursor sobre Lucidscale.
Selecione o modelo do Google Cloud.
Escolha criar um modelo a partir de um projeto existente Google Cloud ou clique em Open Data Central para importar e renderizar um novo projeto.
Clique em + Novo projeto.
Selecione Google Cloud CLI Script.
Abra seu terminal ou prompt de comando e execute o comando: Pip3 install oauth2client google-api-python-client
Inicialize o Gcloud SDK executando o comando: gcloud init
Autentique o Gcloud SDK executando o comando: gcloud auth application-default login
No modal “Novo projeto do Google Cloud ” no Lucid, clique em Baixar script.
- Um arquivo chamado “gcpcliscript.py” será baixado.
Navegue até o local baixado do script e execute o comando: python3 gcpcliscript.py --projects [project_id [project_ids...]] [-c] [-o <output file>]
- projeto: IDs de projeto, podem ser encontrados no console Google Cloud em lista de projeto
- -c: gera o arquivo count.json que contém a contagem de recursos de computação no projeto especificado Google Cloud (opcional)
- -o: nome do arquivo de saída
- por exemplo python3 gcpcliscript.py --projeto bubbly-xxxxxx-233220 summer-alliance-254420 gcpdev-272652
Retorne ao modal “Novo projeto do Google Cloud ” no Lucid e clique em Escolher arquivo.
Selecione e carregue o gcp.json gerado a partir do script.
Clique em Avançar.
edite o nome do projeto e clique em Avançar.
- Após a conclusão da importação, oprojeto será listado como um projetoimportado do Google Cloud no modal após clicar em + Novo > Lucidscale > Modelo do Google Cloud.
- O projeto também será exibido na seção Data central > Google Cloud: Projeto importado.
Selecione Criar novo modelo.
Revise os detalhes e adicione filtros para excluir recursos desnecessários.
Selecione Criar modelo do Google Cloud.

O modelo Lucidscale será gerado em segundo plano na sua conta Lucid. Iremos notificá-lo assim que for processado por meio do modal de status que aparece no canto inferior direito da página.

Saiba mais: para saber como trabalhar com a arquitetura do Google Cloud em um modelo Lucidscale depois que ele for renderizado, confira o artigo vinculado.

Use o Data Central para gerenciar dados e credenciais importados Google Cloud Infrastructure

Projetos importados

Após importar os dados do projeto Google Cloud , eles serão listados como uma fonte de dados com o nome do projeto que você especificou Google Cloud seção "Google Cloud: Projeto importado" do Lucid Data Central. Nessa seção, você também pode clicar em + Novo projeto para importar um novo projeto para o Data Central. O projeto Google Cloud que você importou será listado individualmente no Data Central.

Os projetos listados nesta seção são fontes de dados que podem ser usadas para criar novos modelos Lucidscale. As fontes de dados (“projeto”) contêm os metadados do projeto Google Cloud usados para criar modelos Lucidscale. O campo “Última atualização” indica quando sua fonte de dados foi atualizada pela última vez para contabilizar quaisquer atualizações em seu projeto do Google Cloud conectado.

O Cloud Inventory de cada projeto pode ser visto no lado direito após selecionar um projeto na lista. Este inventário permite ver uma contagem completa de cada tipo de recurso que foi importado antes de criar um modelo. Você também pode baixar um CSV com a lista de recursos e contar diretamente do Data Hub clicando em Baixar CSV.

O inventário lista todos os recursos que podem ser acessados pelas permissões de função atribuídas à sua Conta de Serviço. Se você optar por “Usar uma função somente leitura para todos os recursos”, todos os tipos de recursos no seu projeto que são acessíveis pela função “Visualizador” do Google Cloud serão renderizados no inventário. Se você criar uma função personalizada, somente os tipos de recursos especificados nas permissões de função atribuídas serão renderizados no inventário.

Selecione o menu detrêspontos renderizado em um projeto para ver até seis opções possíveis: Criar novo modelo, Atualizar projeto do Google Cloud, Agendar atualização, Editar recursos, Renomear projeto e Excluir projeto.

Criar novo modelo começará a renderizar a infraestrutura Google Cloud associada ao projeto como um diagrama no espaço de trabalho de um novo modelo. O modelo será gerado em segundo plano na sua página inicial do Lucid e você será notificado assim que ele for renderizado por meio do modal de status que aparece no canto inferior direito da página.

Atualizar projeto do Google Cloud e agendar atualização permite que você atualize manual ou automaticamente os dados do projeto Google Cloud que você importou para o Data central para refletir quaisquer alterações no projeto Google Cloud conectado. Novos modelos criados a partir do projeto após a atualização refletirão quaisquer alterações no projeto Google Cloud conectado.

Saiba mais: para obter mais informações sobre como atualizar o projeto do Google Cloud, consulte nosso artigoAtualizar e sincronizar dados no Lucidscale .

Editar recursos permite editar os recursos incluídos em cada conjunto de dados. Selecionar esta opção abrirá um modal no qual você pode adicionar ou remover quaisquer recursos de conjuntos de dados existentes. Quando terminar a seleção, clique em Salvar e atualizar Projeto. Isso garantirá que o conjunto de dados seja atualizado e os modelos que fazem referência a esse conjunto de dados sejam atualizados com as informações mais recentes.

Tipos de recursos do Google Cloud para importar.png

Renomear projeto permite alterar o nome do conjunto de dados selecionado.

Excluir projeto remove o projeto importado do Lucid Data Central e todos os modelos criados a partir desse projeto perderão a capacidade de atualizar dados do Google Cloud.

Observação: as opções exibidas acima variam dependendo do método de importação usado para uma conta. A opçãode atualização só está disponível com a importação da conta do Google Cloud Service. As importações CLI não oferecem suporte a essa opção.

Credenciais salvas

A seçãoCredenciais salvas em "Data central > Google Cloud" listará as contas de serviço Google Cloud que você pode usar para importar o projeto Google Cloud para o Data central. Nesta seção, você pode clicar em + Nova conta de serviço para adicionar um novo conjunto de credenciais que podem ser usadas para importar um projeto Google Cloud .

Você também pode compartilhar as contas de serviço que criou com outros usuários. Se você clicar no menu de três pontos renderizado em uma conta de serviço, verá duas opções possíveis: Compartilhar credencial e Excluir credencial.

compartilhar credencial abre um modal onde você pode compartilhar uma conta de serviço que você criou com outro usuário na sua conta da Lucid especificando o endereço de e-mail dele. Conceder a eles acesso à conta de serviço permitirá que eles importem o projeto Google Cloud associado para o Data central e criem modelos Lucidscale. Depois que uma credencial for compartilhada com outro usuário, você pode revogar o acesso dele à credencial clicando no X ao lado do endereço de e-mail dele no mesmo modal.

compartilhar-Google-cloud-service-account-credentials.png

Excluir credencial remove uma conta de serviço do Data central. Após excluir uma conta de serviço, todos os projetos que foram importados anteriormente com essa credencial, juntamente com os modelos criados a partir desses projetos, perderiam a capacidade de atualizar dados do Google Cloud.

Saiba mais: Você só pode compartilhar credenciais no Data Hub de sua propriedade. Apenas os usuários Lucidscale atribuídos a uma licença Creator podem importar contas e criar modelos. Para obter mais detalhes, consulte nosso artigoGerenciamento, uso e segurança de credenciais no Lucidscale .

Perguntas frequentes

Após a compra do Lucidscale, todos os usuários da conta terão acesso?
Se você for um cliente Lucid existente (atualmente tem uma assinatura Lucidchart ou Lucidspark ), dependendo das configurações de licenciamento da sua conta, é possível que nem todos os usuários na conta tenham acesso ao Lucidscale por padrão. Um administrador de conta pode precisar atribuir as licenças Lucidscale adquiridas a usuários individuais ou grupos por meio da seção de usuários do Painel do administrador da mesma maneira que Lucidchart e o Lucidspark. Um usuário adicionado a uma conta que tenha apenas uma assinatura Lucidscale (sem assinatura Lucidchart ou Lucidspark atual) receberá automaticamente uma licença Creator ou Explorador, dependendo de quais licenças foram adquiridas. Para obter instruções sobre como conceder licenças, confira o artigo Lucid Painel do administrador: Configurações de licença .

Como a Lucidscale obtém acesso ao nosso ambiente do Google Cloud ? Qual nível de acesso a Lucidscale tem?
O método recomendado pela Lucidscale e Google Cloud é por meio de uma conta de serviço do Google Cloud . Nós fornecemos uma política que nos dá acesso “descrever e listar” ao seu ambiente para que possamos obter um inventário de recursos.

Também temos um método usando um script python que você pode executar por meio da interface de linha de comando (CLI) que gera um arquivo JSON. Os usuários podem fazer upload desse arquivo JSON para o Lucidscale e não preencher nenhuma informação de credencial no Lucidscale. Seu JSON importado estará acessível no Lucid Data Hub para usar na criação de modelos Lucidscale.

Quais APIs o Lucidscale acessa?
Usamos principalmente endpoints de API describe e list.

Você pode escolher quais metadados (os campos e valores mostrados no painel Dados) são importados? Se não, quais metadados são importados?
Não, atualmente você não pode escolher quais metadados são importados. No entanto, estamos procurando criar alguma capacidade de fazer isso no futuro. Todos os metadados de uma chamada de API describe são importados.

Dar feedback sobre este artigo

Tem feedback sobre este artigo? Conte-nos sobre sua experiência aqui.

Artigos relacionados