Modernize your .NET application

Code modernization for .NET, powered by Gemini Generative AI models, is a code generation and application modernization tool. It helps you modernize your Microsoft .NET Framework applications that are Windows-dependent by refactoring your applications to cross-platform .NET code.

Cross-platform .NET applications, unlike .NET Framework applications, can run on Linux, eliminating the need for Windows licenses and enabling cloud-native capabilities including containerization.

In this guide, you'll grant IAM roles for your Google Cloud project, create a Cloud Storage bucket, create a Gemini API key, and install the code-modernization-for-dotnet extension on your local machine to re-factor your .NET Framework application to cross-platform .NET code.

Before you begin

1. Create a Google Account , if you don't already have one. You can use any email address to create a Google Account, including your work email address.
2. Submit the Code Modernization for .NET: Allowlist Request form to join the allow list. You can't proceed with the steps on this page until this request has been approved.
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.

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.

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. Install VS Code , if you haven't already.

Grant Identity and Access Management (IAM) roles

Create a Cloud Storage bucket

To create a Cloud Storage bucket, run the following:

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

Create Gemini API key and save in Secret Manager

To create a Gemini API key, run the following:

 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" 

To save the Gemini API key in Secret Manager, run the following:

 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" 

Install and configure the extension

Once your Code Modernization for .NET: Allowlist Request form is approved, you'll receive the extension as a .VSIX file. To install the extension to your local machine, follow these steps:

1. In VS Code, navigate to Extensionsin the activity bar.

2. Click more_horiz Views and More Actionsand select Install from VSIX.

3. Navigate to and select the VSIX package file. This initiates the installation of the Code-modernization-for-dotnet extension in VS Code on your local machine.

4. Once the installation is complete, restart VS Code.

5. Update Code Modernization for .NET extension settings to the following:

   • Extension Mode: LocalGit (experimental)
   • Project ID: PROJECT_ID
   • Bucket Name: BUCKET_NAME
   • Region: us-central1
   • Gemini API Secret: gemini-api-key-secret-name
   • Google Account: GOOGLE_ACCOUNT
   • Target Framework: .NET 8.0

   Replace the following:

   • PROJECT_ID : The ID of your Google Cloud project—for example, 1234567890 .
   • BUCKET_NAME : The name of your Cloud Storage bucket.
   • GOOGLE_ACCOUNT : Your Google Account—for example, your_full_name@gmail.com .

Trigger the build

1. To login to Google Cloud, run the following command:

    gcloud auth login --update-adc 
   

2. To trigger the modernization workflow, in the activity bar, select Source Control, click more_horiz More Actionsto open the context menu, and select Google Cloud: Modernize .NET code.

Add your project to the allow list

To get your project on the allow list, email your Cloud Build Service Account ID to code-modernization-for-dotnet-discuss@google.com .

You can also contact the same email address for support, to ask questions, or to provide feedback.