.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 Google 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.
Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

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

Enable the APIs

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

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

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

Enable the APIs

3. 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 Google 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

Hinweis : Nachdem Sie das Formular für die Zulassungsliste für die Codemodernisierung für .NET eingereicht haben, müssen Sie warten, bis der Antrag genehmigt wurde, bevor Sie mit den Schritten in diesem Abschnitt fortfahren können.

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 Google Cloud-Projekts, z. B. 1234567890.
   • BUCKET_NAME: Der Name Ihres Cloud Storage-Bucket.
   • GOOGLE_ACCOUNT: Ihr Google-Konto, z. B. [e-mail].

Build auslösen

1. Führen Sie den folgenden Befehl aus, um sich in Google 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 [e-mail].

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