.NET-Anwendung modernisieren

Code Modernization for .NET basiert auf Gemini-Modellen für generative KI und ist ein Tool zur Codegenerierung und Anwendungsmodernisierung. Damit können Sie Ihre Windows-abhängigen Microsoft .NET Framework-Anwendungen modernisieren, indem Sie Ihre Anwendungen in plattformübergreifenden .NET-Code umgestalten.

Plattformübergreifende .NET-Anwendungen können im Gegensatz zu .NET Framework-Anwendungen unter Linux ausgeführt werden. Dadurch sind keine Windows-Lizenzen mehr erforderlich und cloudnative Funktionen wie die Containerisierung werden ermöglicht.

In dieser Anleitung weisen Sie IAM-Rollen für Ihr Trusted Cloud-Projekt zu, erstellen einen Cloud Storage-Bucket, erstellen einen Gemini API-Schlüssel und installieren die code-modernization-for-dotnet-Erweiterung auf Ihrem lokalen Computer, um Ihre .NET Framework-Anwendung in plattformübergreifenden .NET-Code umzugestalten.

Hinweise

1. Erstellen Sie ein Google-Konto, falls Sie noch keines haben. Sie können eine beliebige E‑Mail-Adresse verwenden, um ein Google-Konto zu erstellen, auch Ihre geschäftliche E‑Mail-Adresse.
2. Reichen Sie das Anfrageformular für die Zulassungsliste für Code Modernization for .NET ein, um der Zulassungsliste beizutreten. Sie können erst mit den Schritten auf dieser Seite fortfahren, wenn diese Anfrage genehmigt wurde.

3. In the Trusted Cloud console, on the project selector page, select or create a Trusted Cloud project.

   Go to project selector

4. Verify that billing is enabled for your Trusted Cloud project.

5. Enable the Cloud Build, Secret Manager, Cloud Storage JSON API, Generative Language API, Cloud Logging, and Compute Engine APIs.

   Enable the APIs

6. Installieren Sie VS Code, falls noch nicht geschehen.

IAM-Rollen (Identity and Access Management) zuweisen

Console

1. Wenn Sie die IAM-Rollen für Ihr Trusted Cloud -Projekt zuweisen möchten, rufen Sie die Seite IAM & Verwaltung auf.

   IAM & Verwaltung aufrufen

2. Fügen Sie die folgenden IAM-Rollen hinzu:

• Nutzerberechtigungen

  • Storage Object User(roles/storage.objectUser)
  • Cloud-Build-Bearbeiter (roles/cloudbuild.builds.editor)

• Cloud Build-Dienstkonto

  • Cloud Build-Dienstkonto (roles/cloudbuild.builds.builder)
  • Secret Manager-Betrachter (roles/secretmanager.viewer)
  • Log-Autor (roles/logging.logWriter)
  • Storage Object User(roles/storage.objectUser)

gcloud

Führen Sie die folgenden gcloud-Befehle aus, um die erforderlichen IAM-Rollen hinzuzufügen:

• Weisen Sie die Rolle „Storage Object User“ (roles/storage.objectUser) zu:

  gcloud projects add-iam-policy-binding PROJECT_ID \
  --member="user:USER_ID" \
  --role="roles/storage.objectUser"
  

• Weisen Sie die Rolle „Cloud Build-Bearbeiter“ (roles/cloudbuild.builds.editor) zu:

  gcloud projects add-iam-policy-binding PROJECT_ID \
  --member="user:USER_ID" \
  --role="roles/cloudbuild.builds.editor"
  

• Weisen Sie die Rolle „Cloud Build-Dienstkonto“ (roles/cloudbuild.builds.builder) zu:

  gcloud projects add-iam-policy-binding PROJECT_ID \
    --member="serviceAccount:SERVICE_ACCOUNT" \
    --role="roles/cloudbuild.builds.builder"
  

• Weisen Sie die Rolle „Secret Manager Accessor“ (roles/secretmanager.secretAccessor) zu:

  gcloud projects add-iam-policy-binding PROJECT_ID \
    --member="serviceAccount:SERVICE_ACCOUNT" \
    --role="roles/secretmanager.secretAccessor"
  

• Weisen Sie die Rolle „Logautor“ (roles/logging.logWriter) zu:

  gcloud projects add-iam-policy-binding PROJECT_ID \
    --member="serviceAccount:SERVICE_ACCOUNT" \
    --role="roles/logging.logWriter"
  

• Weisen Sie die Rolle „Storage Object User“ (roles/storage.objectUser) zu:

  gcloud projects add-iam-policy-binding PROJECT_ID \
    --member="serviceAccount:SERVICE_ACCOUNT" \
    --role="roles/storage.objectUser"
  

Cloud Storage-Bucket erstellen

Führen Sie den folgenden Befehl aus, um einen Cloud Storage-Bucket zu erstellen:

gcloud storage buckets create gs://BUCKET_NAME \
--project=PROJECT_ID

Gemini API-Schlüssel erstellen und in Secret Manager speichern

Führen Sie Folgendes aus, um einen Gemini API-Schlüssel zu erstellen:

gcloud services api-keys create --project=PROJECT_ID \
  --display-name="API Key for .Net Modernization" \
  --api-target="service=generativelanguage.googleapis.com" \
  --key-id="gemini-api-key"

Führen Sie Folgendes aus, um den Gemini API-Schlüssel in Secret Manager zu speichern:

echo -n "(gcloud services api-keys get-key-string gemini-api-key \
--project=PROJECT_ID \
--format="value(keyString)")" | \

gcloud secrets create "gemini-api-key" \
--project=PROJECT_ID \
--data-file=- \
--replication-policy="automatic"

Erweiterung installieren und konfigurieren

Sobald Ihr Antragsformular für die Zulassungsliste für die Codemodernisierung für .NET genehmigt wurde, erhalten Sie die Erweiterung als .VSIX-Datei. So installieren Sie die Erweiterung auf Ihrem lokalen Computer:

1. Rufen Sie in VS Code in der Aktivitätsleiste Erweiterungen auf.

2. Klicken Sie auf das more_horiz Ansichten und weitere Aktionen und wählen Sie Über VSIX installieren aus.

3. Suchen Sie die VSIX-Paketdatei und wählen Sie sie aus. Dadurch wird die Installation der Code-modernization-for-dotnet-Erweiterung in VS Code auf Ihrem lokalen Computer gestartet.

4. Starten Sie VS Code nach Abschluss der Installation neu.

5. Aktualisieren Sie die Code Modernization for .NET extension-Einstellungen auf Folgendes:

   • Erweiterungsmodus: LocalGit (experimental)
   • Project ID: PROJECT_ID
   • Bucket-Name: BUCKET_NAME
   • Region: us-central1
   • Gemini API-Secret: gemini-api-key-secret-name
   • Google-Konto: GOOGLE_ACCOUNT
   • Zielframework: .NET 8.0

   Ersetzen Sie Folgendes:

   • PROJECT_ID: Die ID Ihres Trusted Cloud-Projekts, z. B. 1234567890.
   • BUCKET_NAME: Der Name Ihres Cloud Storage-Bucket.
   • GOOGLE_ACCOUNT: Ihr Google-Konto, z. B. your_full_name@gmail.com.

Build auslösen

1. Führen Sie den folgenden Befehl aus, um sich in Trusted Cloudanzumelden:

   gcloud auth login --update-adc
   

2. Wenn Sie den Modernisierungs-Workflow auslösen möchten, wählen Sie in der Aktivitätsleiste Quellcodeverwaltung aus, klicken Sie auf more_horiz Weitere Aktionen, um das Kontextmenü zu öffnen, und wählen Sie Google Cloud: .NET-Code modernisieren aus.

Projekt auf die Zulassungsliste setzen

Wenn Sie Ihr Projekt auf die Zulassungsliste setzen lassen möchten, senden Sie eine E-Mail mit der ID Ihres Cloud Build-Dienstkontos an code-modernization-for-dotnet-discuss@google.com.

Sie können sich auch unter derselben E‑Mail-Adresse an den Support wenden, um Fragen zu stellen oder Feedback zu geben.