Skip to content

Commit bf4a104

Browse files
authored
chore: add instructions to optionally choose predefined tasks to migrate S3 and RabbitMQ (#45)
* chore: add instructions to optionally choose predefined tasks to migrate S3 and RabbitMQ * update * update
1 parent 06c59ac commit bf4a104

File tree

1 file changed

+17
-9
lines changed

1 file changed

+17
-9
lines changed

asset-manager/README.md

Lines changed: 17 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -190,9 +190,10 @@ To successfully complete this workshop, you need the following:
190190
- [VSCode](https://code.visualstudio.com/): The latest version is recommended.
191191
- [A Github account with Github Copilot enabled](https://github.com/features/copilot): All plans are supported, including the Free plan.
192192
- [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.
194193
- [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.
195194
- [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:
196197
- [Azure subscription](https://azure.microsoft.com/free/): Required to deploy the migrated application to Azure.
197198
- [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.
198199
- 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
212213
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.
213214
1. Open the extension `GitHub Copilot app modernization`.
214215
1. In the **QUICKSTART** view, click **Migrate to Azure** button to trigger the Modernization Assessor.
215-
216+
216217
![Trigger Assessment](doc-media/trigger-assessment.png)
217218

218219
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
223224

224225
### Migrate to Azure Database for PostgreSQL Flexible Server using Predefined Tasks
225226

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.
228229
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.
229230
1. When the code is migrated, the extension will prepare the **CVE Validation and Fixing** process. Click **Allow** to proceed.
230231
1. Review the proposed code changes and click **Keep** to apply them.
231232

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
233241

234242
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.
235243

@@ -238,24 +246,24 @@ The following steps demonstrate how to generate custom formulas based on those e
238246
1. Open the sidebar of `GITHUB COPILOT APP MODERNIZATION`. Hover the mouse over the **Tasks** view. Select **Create a Custom Task**.
239247

240248
![Create Formula From Source Control](doc-media/create-formula-from-source-control.png)
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**.
242250

243251
![Create new task](doc-media/create-new-task.png)
244252
1. Type **migrate web** to search for the commits that migrated the **Web** module, and you should see two commits listed:
245253
* migrate web RabbitMQ to azure service bus
246254
* migrate web s3 to azure blob storage
247-
255+
248256
![Migration Commits](doc-media/migration-commits.png)
249257
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.
251259
1. For the next question of **Describe changes using local files (Optional)**, choose **Skip file selection**.
252260

253261
![Skip file selection](doc-media/skip-file-selection.png)
254262
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.
255263
1. Now, the custom task for migrating RabbitMQ is generated and shows under the item of `My Tasks` of the `Tasks` view.
256264
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".
257265
1. Now, the two custom tasks are ready.
258-
266+
259267
![Custom Formulas](doc-media/custom-formulas.png)
260268
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.
261269

0 commit comments

Comments
 (0)