You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: asset-manager/README.md
+17-9Lines changed: 17 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -190,9 +190,10 @@ To successfully complete this workshop, you need the following:
190
190
-[VSCode](https://code.visualstudio.com/): The latest version is recommended.
191
191
-[A Github account with Github Copilot enabled](https://github.com/features/copilot): All plans are supported, including the Free plan.
192
192
-[GitHub Copilot extension in VSCode](https://code.visualstudio.com/docs/copilot/overview): The latest version is recommended.
193
-
-[AppCAT](https://aka.ms/appcat-install): Required for the app assessment feature.
194
193
-[JDK 21](https://learn.microsoft.com/en-us/java/openjdk/download#openjdk-21): Required for the code remediation feature and running the initial application locally.
195
194
-[Maven 3.9.9](https://maven.apache.org/install.html): Required for the assessment and code remediation feature.
195
+
196
+
If you want to deploy the application to Azure, the following are required:
196
197
-[Azure subscription](https://azure.microsoft.com/free/): Required to deploy the migrated application to Azure.
197
198
-[Azure CLI](https://docs.microsoft.com/cli/azure/install-azure-cli): Required if you deploy the migrated application to Azure locally. The latest version is recommended.
198
199
- Fork the [GitHub repository](https://github.com/Azure-Samples/java-migration-copilot-samples) that contains the sample Java application. Please ensure to **uncheck** the default selection "Copy the `main` branch only". Clone it to your local machine. Open the `asset-manager` folder in VSCode and checkout the `main` branch.
@@ -212,7 +213,7 @@ The first step is to assess the sample Java application `asset-manager`. The ass
212
213
1. Open the VS code with all the prerequisites installed on the asset manager by changing the directory to the `asset-manager` directory and running `code .` in that directory.
213
214
1. Open the extension `GitHub Copilot app modernization`.
214
215
1. In the **QUICKSTART** view, click **Migrate to Azure** button to trigger the Modernization Assessor.
1. Wait for the assessment to be completed and the report to be generated.
@@ -223,13 +224,20 @@ The first step is to assess the sample Java application `asset-manager`. The ass
223
224
224
225
### Migrate to Azure Database for PostgreSQL Flexible Server using Predefined Tasks
225
226
226
-
1. After clicking the **Run Task** button in the Solution Report, Copilot Chat panel will be opened with Agent Mode.
227
-
1. The Copilot Agent will firstly analyse the project and generate a migratin plan.
227
+
1. After clicking the **Run Task** button in the Assessment Report, Copilot Chat panel will be opened with Agent Mode.
228
+
1. The Copilot Agent will firstly analyze the project and generate a migration plan.
228
229
1. After the plan is generated, Copilot chat will stop with two generated files: **plan.md** and **progress.md**. Please manually input "Continue" or "Proceed" in the chat to confirm the plan and proceed its following actions to execute the plan.
229
230
1. When the code is migrated, the extension will prepare the **CVE Validation and Fixing** process. Click **Allow** to proceed.
230
231
1. Review the proposed code changes and click **Keep** to apply them.
231
232
232
-
### Migrate to Azure Blob Storage and Azure Service Bus using Custom Tasks
233
+
### Option 1 - Migrate to Azure Blob Storage using Predefined Tasks
234
+
235
+
At this stage, you can use the predefined tasks for other migration scenarios showed in this section, or use the custom tasks showed in the next section (option 2).
236
+
237
+
1. Click the **Run Task** in the Assessment Report, on the right of the row `Storage Migration (AWS S3)` - `Migrate from AWS S3 to Azure Blob Storage`.
238
+
2. The followed steps are the same as the above PostgreSQL server migration.
239
+
240
+
### Option 2 - Migrate to Azure Blob Storage and Azure Service Bus using Custom Tasks
233
241
234
242
The Application `asset-manager` used AWS S3 for image storage and Spring AMQP with RabbitMQ for message queuing. We have already migrated the code of **Web** module to use Azure Blob Storage and Azure Service Bus. These changes are recorded in two separate commits in the `main` branch.
235
243
@@ -238,24 +246,24 @@ The following steps demonstrate how to generate custom formulas based on those e
238
246
1. Open the sidebar of `GITHUB COPILOT APP MODERNIZATION`. Hover the mouse over the **Tasks** view. Select **Create a Custom Task**.
239
247
240
248

241
-
1. In the poped up quick-pick window, select **Create new task**.
249
+
1. In the popped up quick-pick window, select **Create new task**.
242
250
243
251

244
252
1. Type **migrate web** to search for the commits that migrated the **Web** module, and you should see two commits listed:
1. You will create two custom tasks based on the two commits. First, create the task for migrating RabbitMQ. Select the commit of **migrate web RabbitMQ to azure service bus**, click OK.
250
-
1. For the next question of **Select uncommited changes (Optional)**, select nothing and click OK.
258
+
1. For the next question of **Select uncommitted changes (Optional)**, select nothing and click OK.
251
259
1. For the next question of **Describe changes using local files (Optional)**, choose **Skip file selection**.
1. Default task name will be generated. Give it a new name: "custom task migrate RabbitMQ". Press `Enter` to confirm. Then, task description, and search patterns will be generated in order. Press `Enter` repeatedly to confirm.
255
263
1. Now, the custom task for migrating RabbitMQ is generated and shows under the item of `My Tasks` of the `Tasks` view.
256
264
1. Create another custom task for migrating S3. Follow the same steps you just did, select the commit **migrate web s3 to azure blob storage** to create a new custom task with name: "custom task migrate s3".
257
265
1. Now, the two custom tasks are ready.
258
-
266
+
259
267

260
268
1. Select and run the two custom tasks one by one you created in the `Tasks` view of `GITHUB COPILOT APP MODERNIZATION`, one at a time.
0 commit comments