Einrichtung der Organisation

Wenn Sie Cloud Workstations für eine Organisation einrichten, können Sie eine Nutzer-Workstation-Konfiguration mit vorab heruntergeladenem und vorab erstelltem Code erstellen. So können Entwickler sofort mit der Arbeit beginnen, ohne auf den Abschluss des Build-Prozesses warten zu müssen.

Wenn Sie eine Nutzer-Workstation-Konfiguration erstellen möchten, erstellen Sie eine Administrator-Workstation, führen Sie den Build-Prozess einmal aus, erstellen Sie einen Snapshot des nichtflüchtigen Speichers und verwenden Sie diesen Snapshot dann, um eine neue Workstation-Konfiguration zu erstellen.

Administrator-Workstation erstellen

Folgen Sie der Anleitung unter Workstation starten, um eine einzelne Workstation zu erstellen und zu starten. Dieses dient als Basis-Image.

Ziele erstellen

Laden Sie auf der Administrator-Workstation den Quellcode herunter und erstellen Sie die Ziele. Sie können die Ziele entweder manuell erstellen oder die Erstellung mit dem bereitgestellten Script automatisieren.

Manuelle Erstellung

Bevor Sie das Build-Skript ausführen, müssen Sie, wie unter Quellcodezugriff beschrieben, auf den Code zugreifen. Erstellen Sie dann die Ziele manuell, wie unter Herunterladen, Erstellen und Ausführen beschrieben.

Automatisierter Build

Führen Sie das Skript setup.sh aus, das im Repository sdv-setup bereitgestellt wird. Dieses -Skript automatisiert das Klonen des Android-Quellcodes und das Erstellen der Ziele.

  1. Öffnen Sie ein Terminal auf der Workstation.
  2. Git-Anmeldedaten festlegen:

    git config --global user.email "Your email address"
    git config --global user.name "Your name"
    
  3. Bei partner-android.googlesource.com authentifizieren:

    1. Melden Sie sich mit Ihrem Android-Partnerkonto unter partner-android-review.googlesource.com an.
    2. Gehen Sie zu den Einstellungen und wählen Sie Profil aus.
    3. Rufen Sie den Bereich HTTP-Anmeldedaten auf und klicken Sie auf Passwort abrufen.
    4. Folgen Sie der Anleitung auf dem Bildschirm und fügen Sie das Authentifizierungsskript in das Workstation-Terminal ein. Dadurch wird die Datei ~/.gitcookies erstellt, die für den Zugriff erforderlich ist.
  4. Führen Sie das Setupscript aus. Gehen Sie dazu so vor:

    1. Folgen Sie der Anleitung zur Authentifizierung unter Zugriff erhalten. Dadurch erhalten Sie Zugriff auf das Repository für das Setupscript.
    2. Klonen Sie das Repository sdv-setup und führen Sie dann das Setupscript aus:
    # 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
    

Die Ausführung des Skripts dauert mehrere Stunden. Dabei wird der Android-Quellcode geklont (ca. 30 Minuten) und dann werden die Ziele SDV IVI (2 Stunden), Media (30 Minuten) und Core (10 Minuten) erstellt.

(Optional) Android Studio-Projekt für die Plattform einrichten

Android Studio for Platform (ASfP) ist eine IDE, die auf der Cloud Workstation vorinstalliert ist. Wenn alle Ihre Entwickler am selben Projekt arbeiten, können Sie ein ASfP-Projekt im Festplattensnapshot konfigurieren, das alle verwenden können. Folgen Sie der Anleitung unter AAOS SDV-Projekt einrichten, um das Projekt zu konfigurieren.

Laufwerk-Snapshot erstellen

Erstellen Sie nach Abschluss des Builds einen Snapshot des nichtflüchtigen Speichers der Administrator-Workstation.

  1. Entfernen Sie Ihre Git-Konfiguration und Cookies, um zu verhindern, dass persönliche Anmeldedaten für andere Nutzer freigegeben werden:

    rm ~/.gitcookies
    rm ~/.gitconfig
    
  2. Entfernen Sie das sdv-setup-Repository, um das Basis-Image sauber zu halten:

    rm -rf ~/sdv-setup
    
  3. Suchen Sie das Laufwerk der Administrator-Workstation:

    1. Lassen Sie die Administrator-Workstation eingeschaltet.
    2. Geben Sie in der Google Cloud Console VM Instances in die Suchleiste ein und klicken Sie auf das oberste Ergebnis.
    3. Geben Sie in der Leiste Filter workstation_id:work-station ein. work-station muss mit der ID Ihrer Administrator-Workstation übereinstimmen. Drücken Sie die Eingabetaste, um die Ergebnisse zu filtern.
    4. Klicken Sie auf den verbleibenden Eintrag.
    5. Auf der Seite der VM-Instanz sind unter Speicher zwei verschiedene Laufwerke aufgeführt. Klicken Sie auf das Laufwerk mit der Größe (GB) 1000 und dem Typ Regionaler nichtflüchtiger SSD-Speicher. Dieses Laufwerk enthält das Basisverzeichnis, von dem Sie einen Snapshot erstellen möchten.
  4. Beenden Sie die Administrator-Workstation:

    1. Lassen Sie die Seite mit dem Laufwerk geöffnet.
    2. Öffnen Sie in einem neuen Browsertab oder -fenster die Google Cloud Console und rufen Sie die Seite „Cloud Workstations“ auf. Geben Sie in der Suchleiste Cloud Workstations ein und klicken Sie auf das oberste Ergebnis.
    3. Klicken Sie in der Seitenleiste auf Arbeitsplätze.
    4. Klicken Sie in der Tabelle auf die Administrator-Workstation mit der Workstation-ID work-station.
    5. Klicken Sie in der Symbolleiste auf Beenden und warten Sie, bis die Workstation beendet wird.
  5. Erstellen Sie den Laufwerk-Snapshot:

    1. Wechseln Sie zurück zur Seite des Laufwerks und klicken Sie in der Symbolleiste auf Snapshot erstellen.
    2. Geben Sie im Feld Name aaos-sdv-dev-snapshot ein.
    3. Übernehmen Sie für die übrigen Felder die Standardwerte.
    4. Klicken Sie unten auf der Seite auf Erstellen.

Nach kurzer Zeit wird der Laufwerk-Snapshot erstellt und kann verwendet werden.

Workstationkonfiguration für Nutzer erstellen

Erstellen Sie eine neue Workstationkonfiguration, die den Snapshot als Ausgangspunkt verwendet:

  1. Folgen Sie der Anleitung unter Umgebungsvariablen festlegen, um Cloud Shell zu starten und die Umgebungsvariablen festzulegen.
  2. Wenden Sie die Terraform-Konfiguration an, um die Konfiguration der Arbeitsstation des Nutzers zu erstellen:

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

Nutzer-Workstation erstellen

  1. Rufen Sie in der Google Cloud Console die Seite „Cloud Workstations“ auf. Geben Sie Cloud Workstations in die Suchleiste ein und klicken Sie auf das oberste Ergebnis.
  2. Klicken Sie in der Seitenleiste auf Arbeitsplätze.
  3. Klicken Sie in der Symbolleiste auf Workstation erstellen.
  4. Geben Sie eine ID für die Workstation ein oder behalten Sie die Standardeinstellung bei.
  5. Geben Sie einen Anzeigenamen für die Arbeitsstation ein. Wenn Sie dieses Feld leer lassen, wird die ID verwendet.
  6. Wählen Sie user-workstation-config als Konfiguration aus.
  7. Klicken Sie auf Erstellen.
  8. Suchen Sie in der Workstation-Liste nach der Workstation, die Sie gerade erstellt haben. Klicken Sie in der Spalte Schnellaktionen auf Starten.
  9. Klicken Sie nach dem Start der Workstation in der Spalte Schnellaktionen auf Starten, um die Workstation zu verwenden.
  10. Öffnen Sie einen Datei-Explorer, um zu prüfen, ob das Basisverzeichnis die Dateien aus dem Festplattensnapshot enthält.

Ihre Organisation kann jetzt Workstations für ihre Entwickler erstellen. Weitere Informationen zum Einrichten des Zugriffs auf Cloud Workstations finden Sie unter Zugriffssteuerung mit IAM.