Importar y gestionar datos de infraestructura de Google Cloud en Lucidscale

Recursos y líneas de Google Cloud compatibles

Para obtener una lista completa de los recursos y líneas compatibles de Google Cloud que están disponibles en Lucidscale, consulta nuestro artículo Recursos y líneas compatibles con Google Cloud .

Ver: Importación de infraestructura de Google Cloud

Importar infraestructura de Google Cloud

Puedes importar Google Cloud Infrastructure usando uno de los dos métodos: 

• Acceso confiable: proporciona una cuenta de Google Cloud Service con las políticas adecuadas. Esta cuenta de servicio puede configurar con los siguientes ámbitos de licencias:
  • Importar mediante acceso a nivel de proyecto para importar uno o más proyectos individuales
  • Importar mediante acceso a nivel organizacional para importar todos los proyectos dentro de una organización en Google Cloud
• Carga de archivo: ejecuta un script en tu Google Cloud Interfaz de Líneas de Comando (CLI) tecla, que recopila los datos localmente como un archivo JSON y luego sube el archivo generado.
  

Consulta las siguientes tablas para obtener detalles sobre cada método y determinar cuál es el mejor para tu caso de uso.

*El tipo de recurso 1 son todos los recursos mapeados listados en la sección de recursos soportados. El tipo de recurso 2 es Cloud Inventory: una amplia variedad de recursos no mapeados que puedes colocar manualmente en tu modelo.
**Las actualizaciones automáticas de fuentes de datos están disponibles para que Usuario las configure en un calendario recurrente (diario, semanal, mensual, anual) a través del centro de datos. Los refrescos manuales también se realizan con un solo clic a través del centro de datos.

Con importaciones de acceso confiable, Lucid almacena estas credenciales para que puedas actualizar tus datos o hacer nuevas importaciones sin tener que volver a introducir tu información. Esta capacidad de almacenamiento Lucid permite realizar la actualización automática de datos. Las credenciales pueden eliminar a través de la pestaña de credenciales del Data Hub.

Si trabajas con un entorno muy grande, emplea las instrucciones que se encuentran en la sección de configuración del proyecto de este artículo para ayudar a reducir la cantidad de datos que importas o disminuir el número de llamadas a la API que Lucidscale realiza a Google Cloud.

Para renderizar la infraestructura de Google Cloud en un documento de Lucidscale:

1. Haz clic en+ Nuevo en la página de inicio de Lucid.
2. pasar el cursor tu cursor sobre "Lucidscale".
3. Selecciona documento de Google Cloud.
4. Elige crear un documento con un proyectode Google Cloud importado previamente o haz clic en Abrir Centro de Datos para importar un nuevo proyecto.
5. Haz clic en + Proyecto nuevo y elige un método de importación.
   
   • Tras elegir un método de importación y completar la importación, el proyecto aparecerá como fuente de datos en la sección "Google Cloud " del Data Hub. También puedes encontrarlo listado como un proyecto "importado" de Google Cloud en modal tras hacer clic en + New > Lucidscale > documento Google Cloud.
6. Haz clic en el menú de tres puntos junto a la cuenta desde la que quieres crear un documento.
7. En el menú, selecciona Crear nuevo documento.
8. Revisa los detalles y selecciona vistas para agregar solo los recursos necesarios.
   
9. Selecciona Crear documento en Google Cloud.

El documento de Lucidscale se generará en segundo plano de tu cuenta de Lucid. Te notificaremos una vez que se haya renderizado a través del modal de estado que aparece en la parte inferior derecha de la página.

Puedes abrir el documento desde el modal de estado que se muestra justo luego de crear un nuevo documento. El documento (y el documento creado anteriormente) también se almacenará y será accesible en la sección "documento" de tu página de inicio de Lucid después de que lo generes.

Importar proyectos y crear documento a través de la Cuenta de Servicio (Recomendado)

Para importar Google Cloud infraestructura a través de la cuenta de servicio y generar un documento de Lucidscale, sigue estos pasos:

1. En la página de inicio de Lucid, haz clic en+ Nuevo .
2. Pasa el cursor sobre la escala lúcida.
3. Selecciona documento de Google Cloud.
4. Haz clic + Nuevo proyecto.
5. Selecciona la cuenta de Google Cloud Service (recomendada).
6. Haz clic en Crear una nueva cuenta de servicio.
7. En Lucid, selecciona entre las dos opciones para asignar un rol a la Cuenta de Servicio. Haz clic en el siguiente enlace que corresponda con la selección que hiciste en Lucid:
   • Usa un rol de solo lectura para todos los recursos (recomendado)
   • Crear un rol personalizado con permisos mínimos

Paso 2: Asignar un rol a la Cuenta de Servicio usando un rol de solo lectura para todos los recursos (Recomendado)

1. En el siguiente modal en “Paso 1: Crear una nueva cuenta de servicio”, haz clic en Crear cuenta de servicio para abrir una nueva pestaña e iniciar sesión en tu cuenta de Google Cloud. Deja abierta la pestaña del navegador Lucid para que puedas volver a ella según sea necesario. 
2. Asegúrate de que la opción “Usar un rol de solo lectura para todos los recursos (recomendado)” esté seleccionada.
3. En tu consola de Google Cloud, haz clic en Crear cuenta de servicio.
4. Agrega los detalles de la cuenta de servicio y haz clic en Crear y continuar.
5. Haz clic en el menú desplegable “Seleccionar un rol”.
6. Selecciona Básico.
7. Haz clic en Visor.
8. Haz clic en Listo.
9. Salta al paso 3: genera una clave JSON y agrega la cuenta de servicio a Lucidscale.

Paso 2: asigna un rol a la cuenta de servicio creando un rol personalizado con permisos mínimos

1. En tu pestaña Lucid, selecciona la opción “Crear un rol personalizado con permisos mínimos”.
   
2. Haz clic en Descargar luciscale.yaml para descargar el archivo yaml en tu computadora.
3. Selecciona la pestaña Nivel de organización o Nivel de proyecto dependiendo del nivel de datos que quieras visualizar dentro de Lucidscale.
   • En este ejemplo, usaremos la opción Nivel de proyecto.
4. Copia la línea de código resultante que se muestra.
5. Navega a tu consola Google Cloud e inicia sesión.
6. Haz clic en Activar Cloud Shell.
7. Haz clic en el icono de tres puntos encima del terminal Cloud Shell y selecciona Subir.
8. Navega hasta el archivo yaml descargado anteriormente y súbirlo.
9. Pegue la línea de código copiada (del paso 4 anterior) en el terminal y reemplace los siguientes valores dentro de la línea de código:
   • role-id = el valor que quieres usar para tu ID de rol
   • project-id = tu ID de proyecto en Google Cloud
   • yaml-file-path = ruta al yaml archivo
   • El resultado final debería verse así (usando valores falsos):
     • los roles de gcloud iam crean lucidscalerole --project=test-project-id --file=lucidscale.yaml
   • Si estás usando la línea de código de nivel organizacional, el ejemplo se vería así (también usando valores falsos):
     • los roles de gcloud iam crean lucidscalerole --organization=test-organization-id --file=lucidscale.yaml
10. Haz clic en Autorizar.
11. En la terminal, se te dará el aviso “¿Estás seguro de que quieres hacer este cambio (Y/N)?”. Escribe “Y” y haz clic en Entrar.
12. Continúa con el paso 3: genera una clave JSON y agrega la cuenta de servicio a Lucidscale a continuación.

Paso 3: Genera una clave JSON y agrega la Cuenta de Servicio a Lucidscale

1. En tu consola Google Cloud, selecciona la cuenta de servicio que creaste en el paso 1.8.
2. Haz clic en la pestaña “Teclas”.
3. Selecciona Agregar clave y haz clic en Crear nueva clave.
4. Elige JSON como el “tipo de clave”.
5. Haz clic en Crear.
6. Se descargará un archivo JSON en tu dispositivo.
7. Vuelve a la pestaña abierta de tu navegador Lucid.
8. Selecciona Elegir archivo.
9. Localiza y selecciona subir el archivo JSON que descargaste en el paso 6.
10. Haz clic en Siguiente.

Paso 4: Agregar proyectos y crear documento

1. Selecciona el(los) proyecto(s) que quieres importar al Data Hub y úsalo para generar un documento de Lucidscale.
   
2. Haz clic en Siguiente.
3. Seleccionar recursos para importar.
   
4. Seleccione Importar proyectos de Google Cloud.

Puedes abrir el documento desde el modal de estado que se muestra justo luego de crear un nuevo documento. El documento (y el documento creado anteriormente) también se almacenará y será accesible en la sección "documento" de tu página de inicio de Lucid después de que lo generes.

Configuración del proyecto usando una cuenta de servicio

Al importar un proyecto de Google Cloud al Lucid Data Hub usando el método de cuenta de servicio, puedes omitir los tipos de recursos o metadatos seleccionados de la importación. Esto te permite visualizar solo los tipos de recursos que te interesan y, en algunos casos, puede aumentar la velocidad de la importación. Lostipos de recursos y metadatos desseleccionados no se importarán ni renderizarán en el diagrama.

Importar proyectos y crear documentos mediante Google Cloud CLI

Instala Python si aún no lo tienes. Las instrucciones se pueden encontrar aquí. Asegúrese de marcar la opción "Agregar Python a PATH" en el instalador. Puede verificar que Python se instaló correctamente probando los comandos "python" o "python 3" en una terminal (MAC OS) o en el símbolo del sistema (Windows).

1. En la página de inicio de Lucid, haz clic en+ Nuevo .
2. Pasa el cursor sobre la escala lúcida.
3. Selecciona documento de Google Cloud.
4. Elige crear un documento a partir de un proyecto existente de Google Cloud o haz clic en Abrir Data Hub para importar y renderizar un nuevo proyecto.
5. Haz clic + Nuevo proyecto.
6. Selecciona Google Cloud CLI Script.
7. Abre tu terminal o símbolo del sistema y ejecuta el comando: Pip3 install oauth2client google-api-python-client
8. Inicializa el SDK de Gcloud ejecutando el comando: gcloud init
9. Autenticar el SDK de Gcloud ejecutando el comando: gcloudauth application-default login
10. En el modal "Nuevo proyecto Google Cloud" en Lucid, haz clic en Descargar script.
    • Se descargará un archivo llamado "gcpcliscript.py".
      
       
11. Navega hasta la ubicación descargada del script y ejecuta el comando tecla: python3 gcpcliscript.py --projects [project_id [project_ids...]] [-c] [-o] <output file>
    • project_ids: Los ID de proyecto, se pueden encontrar en la consola de Google Cloud bajo lista de proyectos
    • -c: genera el archivo count.json que contiene el recuento de recursos de cálculo en los proyectos Google Cloud especificados (opcional)
    • -o: nombre del archivo de salida
    • p.ej python3 gcpcliscript.py --proyectos bubbly-xxxxxx-233220 summer-alliance-254420 gcpdev-272652
12. Vuelve al modal "Nuevo proyecto Google Cloud" en Lucid y haz clic en Elegir archivo.
13. Selecciona y sube el gcp.json generado a partir del script.
14. Haz clic en Siguiente.
15. editar el nombre del proyecto y hacer clic en Siguiente.
    • Una vez finalizada la importación, elproyecto aparecerá como un proyecto de Google Cloud importado en modal tras hacer clic en + New > Lucidscale > Google Cloud documento.
    • El proyecto también se mostrará en la sección Data Hub > Google Cloud: Proyectos importados.
16. Selecciona Crear nuevo documento.
17. Revisa los detalles y agrega filtros para excluir recursos innecesarios.
18. Selecciona Crear documento en Google Cloud.

El documento de Lucidscale se generará en segundo plano de tu cuenta de Lucid. Te notificaremos una vez que se haya renderizado a través del modal de estado que aparece en la parte inferior derecha de la página.

Puedes abrir el documento desde el modal de estado que se muestra justo luego de crear un nuevo documento. El documento (y el documento creado anteriormente) también se almacenará y será accesible en la sección "documento" de tu página de inicio de Lucid después de que lo generes.

Emplea el Data Hub para gestionar los datos y credenciales importados de Google Cloud Infrastructure

Proyectos importados

Tras importar los datos del proyecto Google Cloud, aparecerá como fuente de datos con el nombre del proyecto que especificaste en la sección "Google Cloud: Proyectos importados" del Lucid Data Hub. Desde esta sección también puedes hacer clic en + Nuevo proyecto para importar un nuevo proyecto al Data Hub. Los proyectos de Google Cloud que importaste se listarán individualmente en el Data Hub.

Los proyectos listados en esta sección son fuentes de datos que pueden emplear para crear un nuevo documento de Lucidscale. Las fuentes de datos ("Proyectos") contienen los metadatos Google Cloud del proyecto empleados para crear documentos de Lucidscale. El campo "Última actualización" indica cuándo se actualizó por última vez tu fuente de datos para tener en cuenta cualquier actualización en tu proyecto Google Cloud conectado.

El Inventario en la Nube de cada proyecto puede ver en el lado derecho tras seleccionar un proyecto de la lista. Este inventario te permite ver el recuento completo de cada tipo de recurso importado antes de crear un documento. También puedes descargar un CSV con la lista de recursos y contar directamente desde el Data Hub haciendo clic en Descargar CSV.

El inventario enumera todos los recursos a los que se puede acceder mediante las licencias de rol asignados a su cuenta de servicio. Si elige “Usar un rol de solo lectura para todos los recursos”, todos los tipos de recursos en su proyecto a los que se puede acceder mediante Google Cloud el rol “lector” de se representarán en el inventario. Si crea un rol personalizado, solo se representarán en el inventario los tipos de recursos especificados en las licencias de rol asignados. 

Selecciona el menú de tres puntos que se muestra en un proyecto para ver hasta seis opciones potenciales: Crear nuevo documento, Actualizar el proyecto desde Google Cloud, Programar la actualización, editar recursos, Renombrar el proyecto y Eliminar el proyecto.

Crear un nuevo documento mostrará la infraestructura Google Cloud asociada al proyecto como un diagrama en el espacio de trabajo de un nuevo documento. El documento se generará en segundo plano de tu página de inicio de Lucid y se te notificará una vez que se haya renderizado a través del modal de estado que aparece en la parte inferior derecha de la página.

Actualizar el proyecto desde Google Cloud y la actualización de calendario te permiten actualizar manual o automáticamente los datos Google Cloud del proyecto que importaste al Data Hub para reflejar cualquier cambio en el proyecto Google Cloud conectado. El nuevo documento creado a partir del proyecto tras la actualización reflejará cualquier cambio en el proyecto Google Cloud conectado. 

Editar Resources te permite editar los recursos incluidos en cada conjunto de datos. Seleccionar esta opción abrirá un modal en el que puedes agregar o eliminar recursos de conjuntos de datos existentes. Cuando termines con la selección, haz clic en Almacenar y actualizar Proyecto. Esto garantizará que las actualizaciones del conjunto de datos y el documento que hace referencia a ese conjunto se actualicen con la información más reciente.
 

Cambiar nombre de proyecto te permite cambiar el nombre del conjunto de datos seleccionado.

Eliminar el proyecto elimina el proyecto importado del Lucid Data Hub y cualquier documento creado a partir de ese proyecto perdería la capacidad de actualizar datos desde Google Cloud. Puedes importar el mismo proyecto de Google Cloud más de una vez: cada uno crea una fuente de datos independiente. No es necesario eliminar un proyecto existente antes de volver a importarlo.

Credenciales guardadas

La secciónde Credenciales Almacenadas en "Data Hub > Google Cloud" mostrará las cuentas del servicio Google Cloud que puedes usar para importar proyectos de Google Cloud al Data Hub. Desde esta sección puedes hacer clic + Cuenta de Nuevo Servicio para agregar un nuevo conjunto de credenciales que se pueden usar para importar un proyecto de Google Cloud.  

También puedes compartir las cuentas de servicio que has creado con otros usuarios. Si haces clic en el menú de tres puntos en una cuenta de servicio, verás dos opciones potenciales: Compartir credencial y Eliminar credencial.

La credencial Comparte abre un modal donde puedes compartir una cuenta de servicio que creaste con otro usuario en tu cuenta Lucid especificando su dirección de email. Concederles acceso a la cuenta de servicio les permitirá importar el proyecto de Google Cloud asociado al Data Hub y crear documentos de Lucidscale. Después de que una credencial fue compartida con otro usuario, puedes revocar su acceso a la credencial haciendo clic en la X junto a su dirección de email en el mismo modal.

Eliminar credenciales elimina una cuenta de servicio del Data Hub. Tras eliminar una cuenta de servicio, todos los proyectos que se importaron previamente con esa credencial junto con documentos creados a partir de esos proyectos perderían la capacidad de actualizar datos desde Google Cloud.  

Preguntas frecuentes

¿Cómo consigue Lucidscale acceso a nuestro entorno Google Cloud? ¿Qué nivel de acceso tiene Lucidscale?
El método recomendado de Lucidscale y Google Cloud es a través de una cuenta de Google Cloud Service. Ofrecemos una política que nos da acceso de "describir y listar" a tu entorno para poder obtener un inventario de recursos.

También tenemos un método usando un script en python que puedes ejecutar a través de la interfaz Command líneas (CLI) de tecla, que genera un archivo JSON. El usuario puede entonces subir este archivo JSON a Lucidscale y no llenar ninguna información de credenciales en Lucidscale. Tu JSON importado estará disponible en Lucid Data Hub para usarlo y crear documentos en Lucidscale.

¿A qué APIs accede Lucidscale?
Principalmente empleamos endpoints de API para describir y listar.

¿Puedes elegir qué metadatos (los campos y valores que se muestran en el panel de datos) se importa? Si no, ¿qué metadatos se importan?
No, actualmente no puedes elegir qué metadatos importar. Sin embargo, buscamos crear cierta capacidad para hacerlo en el futuro. Se importan todos los metadatos de una llamada a la API de descripción.

Da tu opinión sobre este artículo