Configuración de la organización

Si configuras Cloud Workstations para una organización, puedes crear una configuración de estación de trabajo del usuario con código compilado y descargado previamente. Esto permite que los desarrolladores comiencen a trabajar de inmediato sin esperar a que se complete el proceso de compilación.

Para crear una configuración de estación de trabajo del usuario, debes crear una estación de trabajo de administrador, ejecutar el proceso de compilación una vez, crear una instantánea del disco persistente y, luego, usar esa instantánea para crear una nueva configuración de estación de trabajo.

Crear una estación de trabajo de administrador

Sigue los pasos que se indican en Cómo iniciar la estación de trabajo para crear y, luego, iniciar una sola estación de trabajo. Esta será tu imagen base.

Compila los destinos

En la estación de trabajo de administrador, descarga el código fuente y compila los destinos. Puedes compilar los destinos de forma manual o automatizar la compilación con la secuencia de comandos proporcionada.

Compilación manual

Antes de ejecutar la secuencia de comandos de compilación, obtén acceso al código como se describe en Acceso al código fuente. Luego, compila los objetivos de forma manual como se describe en Descarga, compila y ejecuta.

Compilación automatizada

Ejecuta la secuencia de comandos setup.sh que se proporciona en el repositorio sdv-setup. Esta secuencia de comandos de automatiza la clonación del código fuente de Android y la compilación de los destinos.

  1. Abre una terminal en la estación de trabajo.
  2. Configura tus credenciales de Git:

    git config --global user.email "Your email address"
    git config --global user.name "Your name"
    
  3. Autentícate en partner-android.googlesource.com:

    1. Accede a partner-android-review.googlesource.com con tu cuenta de socio de Android.
    2. Ve a Configuración y, luego, selecciona Perfil.
    3. Ve a la sección Credenciales HTTP y, luego, haz clic en Obtener contraseña.
    4. Sigue las instrucciones en pantalla y, luego, pega la secuencia de comandos de autenticación en la terminal de la estación de trabajo. Esto crea el archivo ~/.gitcookies, que es necesario para el acceso.
  4. Para ejecutar la secuencia de comandos de configuración, completa los siguientes pasos:

    1. Sigue los pasos de autenticación en Obtén acceso. Esto proporciona acceso al repositorio de secuencias de comandos de configuración.
    2. Clona el repositorio sdv-setup y, luego, ejecuta la secuencia de comandos de configuración:
    # Change directories to the home directory
    cd ~/
    
    # Clone the sdv-setup repository
    git clone https://sdv.googlesource.com/external/sdv-setup
    
    # Ensure the setup script is executable
    chmod +x sdv-setup/setup/setup.sh
    
    # Run the setup script
    ./sdv-setup/setup/setup.sh
    

La secuencia de comandos tarda varias horas en completarse. Clona el código fuente de Android (aproximadamente 30 minutos) y, luego, compila los destinos SDV IVI (2 horas), Media (30 minutos) y Core (10 minutos).

(Opcional) Configura un proyecto de Android Studio para la plataforma

Android Studio for Platform (ASfP) es un IDE preinstalado en la estación de trabajo en la nube. Si todos tus desarrolladores trabajan en el mismo proyecto, puedes configurar un proyecto de ASfP en la instantánea de disco que todos puedan usar. Sigue las instrucciones que se indican en Cómo configurar un proyecto de SDV de AAOS para configurar el proyecto.

Crea una instantánea de disco

Una vez que se complete la compilación, crea una instantánea del disco persistente de la estación de trabajo de administrador.

  1. Quita tu configuración de Git y las cookies para evitar compartir credenciales personales con otros usuarios:

    rm ~/.gitcookies
    rm ~/.gitconfig
    
  2. Quita el repositorio sdv-setup para mantener limpia la imagen base:

    rm -rf ~/sdv-setup
    
  3. Busca el disco de la estación de trabajo de administrador:

    1. Mantén en funcionamiento la estación de trabajo de administrador.
    2. En la consola de Google Cloud, ingresa VM Instances en la barra de búsqueda y, luego, haz clic en el primer resultado.
    3. En la barra de filtros, ingresa workstation_id:work-station. work-station debe coincidir con el ID de tu estación de trabajo de administrador. Presiona Intro para filtrar los resultados.
    4. Haz clic en la entrada restante.
    5. En la página de la instancia de VM, se muestran dos discos diferentes en Almacenamiento. Haz clic en el disco que tiene un Tamaño (GB) de 1,000 y un Tipo de Disco persistente SSD regional. Este disco contiene el directorio principal del que quieres tomar una instantánea.
  4. Detén la estación de trabajo de administrador:

    1. Mantén abierta la página del disco.
    2. En una nueva pestaña o ventana del navegador, abre la consola de Google Cloud y navega a la página de Cloud Workstations. En la barra de búsqueda, ingresa Cloud Workstations y, luego, haz clic en el primer resultado.
    3. Haz clic en Estaciones de trabajo en el panel lateral.
    4. Haz clic en la estación de trabajo de administrador (con el ID de estación de trabajo work-station) en la tabla.
    5. Haz clic en Detener en la barra de herramientas y, luego, espera a que se detenga la estación de trabajo.
  5. Crea la instantánea de disco:

    1. Vuelve a la página del disco y, luego, haz clic en Crear instantánea en la barra de herramientas.
    2. En el campo Nombre, ingresa aaos-sdv-dev-snapshot.
    3. Deja los campos restantes con sus valores predeterminados.
    4. Al final de la página, haz clic en Crear.

Después de un breve período, se creará la instantánea del disco y estará lista para usarse.

Crea la configuración de la estación de trabajo del usuario

Crea una nueva configuración de estación de trabajo que use la instantánea como punto de partida:

  1. Sigue las instrucciones en Cómo establecer variables de entorno para iniciar Cloud Shell y, luego, establecer las variables de entorno.
  2. Aplica la configuración de Terraform para crear la configuración de la estación de trabajo del usuario:

    cd ~/dev/sdv-setup/tf/user_dev_env
    terraform init
    terraform apply -auto-approve
    

Crea una estación de trabajo del usuario

  1. En la consola de Google Cloud, navega a la página de Cloud Workstations. Ingresa Cloud Workstations en la barra de búsqueda y, luego, haz clic en el primer resultado.
  2. Haz clic en Estaciones de trabajo en el panel lateral.
  3. Haz clic en Crear estación de trabajo en la barra de herramientas.
  4. Ingresa un ID para la estación de trabajo o conserva el valor predeterminado.
  5. Ingresa un nombre visible para la estación de trabajo. Si dejas este campo en blanco, se usará el ID.
  6. Selecciona user-workstation-config como la configuración.
  7. Haz clic en Crear.
  8. En la lista de estaciones de trabajo, busca la que acabas de crear. Haz clic en Iniciar en la columna Acciones rápidas.
  9. Después de que se inicie la estación de trabajo, haz clic en Iniciar en la columna Acciones rápidas para comenzar a usarla.
  10. Abre un explorador de archivos para verificar que el directorio principal contenga los archivos de la instantánea del disco.

Ahora tu organización puede crear estaciones de trabajo para sus desarrolladores. Para obtener más información sobre cómo configurar el acceso a Cloud Workstations, consulta Control de acceso con IAM.