Moderniser votre application .NET

La modernisation du code pour .NET, optimisée par les modèles d'IA générative Gemini, est un outil de génération de code et de modernisation d'applications. Il vous aide à moderniser vos applications Microsoft .NET Framework dépendantes de Windows en refactorisant vos applications en code .NET multiplate-forme.

Contrairement aux applications .NET Framework, les applications .NET multiplate-formes peuvent s'exécuter sous Linux, ce qui élimine le besoin de licences Windows et permet d'utiliser des fonctionnalités cloud natives, y compris la conteneurisation.

Dans ce guide, vous allez attribuer des rôles IAM pour votre projet Trusted Cloud, créer un bucket Cloud Storage, créer une clé API Gemini et installer l'extension code-modernization-for-dotnet sur votre machine locale pour refactoriser votre application .NET Framework en code .NET multiplate-forme.

Avant de commencer

1. Créez un compte Google si vous n'en avez pas déjà un. Vous pouvez utiliser n'importe quelle adresse e-mail pour créer un compte Google, y compris votre adresse e-mail professionnelle.
2. Remplissez le formulaire de demande d'ajout à la liste d'autorisation pour la modernisation du code .NET. Vous ne pouvez pas suivre les étapes de cette page tant que cette demande n'a pas été approuvée.

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. Installez VS Code, si ce n'est pas déjà fait.

Attribuer des rôles IAM (Identity and Access Management)

Console

1. Pour attribuer les rôles IAM à votre projet Trusted Cloud , accédez à la page IAM et administration.

   Accéder à IAM et administration

2. Ajoutez les rôles IAM suivants :

• Autorisations utilisateur

  • Utilisateur des objets de l'espace de stockage (roles/storage.objectUser)
  • Éditeur Cloud Build (roles/cloudbuild.builds.editor)

• Compte de service Cloud Build

  • Compte de service Cloud Build (roles/cloudbuild.builds.builder)
  • Lecteur Secret Manager (roles/secretmanager.viewer)
  • Rédacteur de journaux (roles/logging.logWriter)
  • Utilisateur des objets de l'espace de stockage (roles/storage.objectUser)

gcloud

Pour ajouter les rôles IAM requis, exécutez les commandes gcloud suivantes :

• Attribuez le rôle Utilisateur d'objets de stockage (roles/storage.objectUser) :

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

• Attribuez le rôle Éditeur Cloud Build (roles/cloudbuild.builds.editor) :

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

• Attribuez le rôle Compte de service Cloud Build (roles/cloudbuild.builds.builder) :

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

• Attribuez le rôle Accesseur de secrets Secret Manager (roles/secretmanager.secretAccessor) :

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

• Attribuez le rôle Rédacteur de journaux (roles/logging.logWriter) :

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

• Attribuez le rôle Utilisateur d'objets de stockage (roles/storage.objectUser) :

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

Créer un bucket Cloud Storage

Pour créer un bucket Cloud Storage, exécutez la commande suivante :

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

Créer une clé API Gemini et l'enregistrer dans Secret Manager

Pour créer une clé API Gemini, exécutez la commande suivante :

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"

Pour enregistrer la clé API Gemini dans Secret Manager, exécutez la commande suivante :

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"

Installer et configurer l'extension

Une fois votre formulaire de demande d'ajout à la liste d'autorisation pour la modernisation du code .NET approuvé, vous recevrez l'extension sous la forme d'un fichier .VSIX. Pour installer l'extension sur votre machine locale, procédez comme suit :

1. Dans VS Code, accédez à Extensions dans la barre d'activité.

2. Cliquez sur more_horiz Vues et autres actions, puis sélectionnez Installer à partir de VSIX.

3. Accédez au fichier du package VSIX et sélectionnez-le. Cela lance l'installation de l'extension Code-modernization-for-dotnet dans VS Code sur votre machine locale.

4. Une fois l'installation terminée, redémarrez VS Code.

5. Mettez à jour les paramètres Code Modernization for .NET extension comme suit :

   • Mode étendu : LocalGit (experimental)
   • ID du projet : PROJECT_ID
   • Nom du bucket : BUCKET_NAME
   • Région : us-central1
   • Code secret de l'API Gemini : gemini-api-key-secret-name
   • Compte Google : GOOGLE_ACCOUNT
   • Framework cible : .NET 8.0

   Remplacez les éléments suivants :

   • PROJECT_ID : ID de votre projet Trusted Cloud, par exemple 1234567890.
   • BUCKET_NAME : nom de votre bucket Cloud Storage.
   • GOOGLE_ACCOUNT : votre compte Google, par exemple your_full_name@gmail.com.

Déclencher la compilation

1. Pour vous connecter à Trusted Cloud, exécutez la commande suivante :

   gcloud auth login --update-adc
   

2. Pour déclencher le workflow de modernisation, dans la barre d'activité, sélectionnez Gestion de code source, cliquez sur more_horiz Autres actions pour ouvrir le menu contextuel, puis sélectionnez Google Cloud : Moderniser le code .NET.

Ajouter votre projet à la liste d'autorisation

Pour ajouter votre projet à la liste d'autorisation, envoyez l'ID de votre compte de service Cloud Build à code-modernization-for-dotnet-discuss@google.com.

Vous pouvez également contacter cette adresse e-mail pour obtenir de l'aide, poser des questions ou nous faire part de vos commentaires.