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
## Purpose
## Does this introduce a breaking change?
<!-- Mark one with an "x". -->
```
[ ] Yes
[x] No
```
## Pull Request Type
What kind of change does this Pull Request introduce?
<!-- Please check the one that applies to this PR using "x". -->
```
[x] Bugfix
[ ] Feature
[ ] Code style update (formatting, local variables)
[ ] Refactoring (no functional changes, no api changes)
[ ] Documentation content changes
[ ] Other... Please describe:
```
Copy file name to clipboardExpand all lines: docs/02_lab_launch/0202.md
+1-1
Original file line number
Diff line number
Diff line change
@@ -34,7 +34,7 @@ This involves three things:
34
34
```
35
35
36
36
{: .note }
37
-
> Not all regions support Azure Container Apps environments and Azure Database for MySQL - Flexible Server instances. For more info, please refer to [Region availability]({% link tips.md %}#region-availability).
37
+
> Not all regions support Azure Container Apps environments and Azure Database for MySQL - Flexible Server instances. For more info, please refer to [Region availability]({% link index.md %}#region-availability).
38
38
39
39
{: .note }
40
40
> This lab uses quite a few environment variables. If you’re using a codespace to run this lab and the codespace restarts, your environment variables will be lost. For methods to persist these environment variables across codespace sessions, go to the [LabTips]({% link tips.md %}) section.
Copy file name to clipboardExpand all lines: docs/03_lab_openai/03_openai.md
+1-1
Original file line number
Diff line number
Diff line change
@@ -34,7 +34,7 @@ Your first step in this process is to create a new Spring Boot application:
34
34
35
35
You’ll also need to provide additional settings, such as project type, Java code details, and naming to match the structure of the existing Spring Petclinic application.
36
36
37
-
To create the new Spring Boot application using these settings, in your command-line window, go to the `src` folder of your local code repo and run the following command:
37
+
To create the new Spring Boot application using these settings, in your command-line window, go to the `spring-petclinic-microservices` folder of your local code repo and run the following command:
Copy file name to clipboardExpand all lines: install.md
+11-12
Original file line number
Diff line number
Diff line change
@@ -11,10 +11,10 @@ nav_order: 2
11
11
12
12
Before you begin working through the lab, you’ll need to make sure that you have all the required tools installed and configured in your development environment, and that your Azure subscription is ready for the labs. Please complete the following steps before proceeding:
13
13
14
-
1.**[Set up your development environment using GitHub Codespaces](#use-github-codespaces-strongly-recommended).** This will give you a fully configured development environment without requiring any software installation or configuration on your local workstation. This environment will also contain a cloned copy of the example Spring Petclinic workload code from the GitHub repo.
14
+
1.**[Set up your development environment using GitHub Codespaces](#use-github-codespaces-strongly-recommended).** This will give you a fully configured development environment without requiring any software installation or configuration on your local workstation. This environment will also contain a cloned copy of the example Spring Petclinic workload code from the GitHub repo.
15
15
2.**[Configure your subscription and deploy prerequisite Azure resources](#configure-your-subscription-and-deploy-prerequisite-azure-resources).** Once you've set up your dev environment, you'll need to run a couple scripts that will automate some required subscription configuration and resources deployment tasks.
16
16
17
-
These setup tasks can take several minutes to complete, so we suggest starting this process as soon as possible.
17
+
These setup tasks can take several minutes to complete, so we suggest starting this process as soon as possible.
18
18
19
19
### Alternative development environment options
20
20
@@ -24,7 +24,7 @@ If you are unable to use a Codespace, there's two alternative ways to set up a d
24
24
-[Install all the tools on your local machine (not recommended)](#optional-install-all-the-tools-on-your-local-machine-not-recommended)
25
25
26
26
{: .important }
27
-
> We’ve tested all the steps of this lab in [GitHub Codespaces](#use-github-codespaces), which is the simplest way to get going and the preferred option for running the lab. Support for these alternative options during the lab may be limited. Use a Codespace if at all possible.
27
+
> We’ve tested all the steps of this lab in [Use GitHub Codespaces](#use-github-codespaces), which is the simplest way to get going and the preferred option for running the lab. Support for these alternative options during the lab may be limited. Use a Codespace if at all possible.
28
28
29
29
30
30
## Use GitHub Codespaces (strongly recommended)
@@ -92,7 +92,7 @@ Now you'll run the script `prepare.sh` to register the required resources provid
92
92
./tools/prepare.sh
93
93
```
94
94
95
-
This process should take less than 10 minutes to complete.
95
+
This process should take less than 10 minutes to complete.
96
96
97
97
1. Once the `prepare.sh` script finishes, close your current terminal window and start a new terminal session to ensure you're accessing a fully prepared lab environment.
98
98
@@ -105,7 +105,7 @@ You'll now run the script `create-azure-resource.sh`, which will create several
105
105
- `UNIQUEID` - Create a unique ID string and paste that in the code editor. You can use the following command generate an acceptable value: `openssl rand -hex 3`
106
106
- `SUBSCRIPTION` - Enter the ID of the subscription you're going to work in. To quickly find this id, use the following command: `az account show --query id`
107
107
- `REGION` - Enter the default Azure region you want to work in. For example `westus` or `southindia`.
108
-
- `MYSQL_ADMIN_PASSWORD` - enter a strong password string.
108
+
- `MYSQL_ADMIN_PASSWORD` - enter a strong password string.
109
109
110
110
After setting these values, save the updated `azure-resource.profile` file before proceeding.
111
111
@@ -136,9 +136,9 @@ You'll now run the script `create-azure-resource.sh`, which will create several
136
136
>
137
137
> Before you do anything else, run the command `saveenv` in your open command-line window. This will save all of your currently defined environment variables to the file `~/.dev-environment`. The next time you start a new bash session you will automatically load the saved variables from this file.
138
138
>
139
-
> You can also manually load the saved variables with the command `loadenv`.
140
-
>
141
-
> You can use these commands at any time, so feel free to run `saveenv` after creating or updating environment variables when working through the labs, or `loadenv` to reload your saved variables as needed.
139
+
> You can also manually load the saved variables with the command `loadenv`.
140
+
>
141
+
> You can use these commands at any time, so feel free to run `saveenv` after creating or updating environment variables when working through the labs, or `loadenv` to reload your saved variables as needed.
142
142
143
143
144
144
## (Optional) Use Visual Studio Code with remote containers
@@ -184,7 +184,7 @@ To get started working in the dev container:
1. When prompted to sign in to GitHub, select**Signin with your browser**. This will automatically open a new tab in the web browser window, prompting you to provide your GitHub username and password.
@@ -197,9 +197,8 @@ To get started working in the dev container:
197
197
1. Go to the java-on-aca folder where you cloned the project, and open the project with Visual Studio Code.
1. With the [Visual Studio Code Remote Containers extension](https://code.visualstudio.com/docs/remote/containers) installed, you can now open the project in a remote container. This will reopen the project in a Docker container with all the tooling installed.
Copy file name to clipboardExpand all lines: tips.md
+5-5
Original file line number
Diff line number
Diff line change
@@ -14,15 +14,15 @@ Tips in this section include:
14
14
15
15
## Use GitHub Codespaces
16
16
17
-
As described in the [installation instructions]({% link install.md %}), the best and easiest way to run this lab is to use [GitHub Codespaces](https://github.com/features/codespaces). With the devcontainer.json file provided in the lab's [GitHub repository](https://github.com/Azure-Samples/java-on-aca) you can create a codespace that has the required tools pre-installed and configured for you. The steps in this lab have been thoroughly tested with the codespace configuration included in the repo.
17
+
As described in the [installation instructions]({% link install.md %}), the best and easiest way to run this lab is to use [GitHub Codespaces](https://github.com/features/codespaces). With the devcontainer.json file provided in the lab's [GitHub repository](https://github.com/Azure-Samples/java-on-aca) you can create a codespace that has the required tools pre-installed and configured for you. The steps in this lab have been thoroughly tested with the codespace configuration included in the repo.
18
18
19
-
If you're unable to use a codespace, the best alternative is Visual Studio Code with remote containers, which allows you to deploy and work with a preconfigured Docker development environment.
19
+
If you're unable to use a codespace, the best alternative is Visual Studio Code with remote containers, which allows you to deploy and work with a preconfigured Docker development environment.
20
20
21
21
If you can't use either of these options, you can complete this lab by installing the required tooling on your local environment. However, since it’s impossible for us to test all lab steps with every possible local configuration, we highly recommend using either GitHub Codespaces or the Visual Studio Code with remote containers.
22
22
23
-
## Use .azcli files to make command line work easier
23
+
## Use .azcli files to make command line work easier
24
24
25
-
If you're using Visual Studio Code, you can record the command-line statements that you execute in a file with the _.azcli_ extension. This extension, combined with the [Azure CLI Tools](https://marketplace.visualstudio.com/items?itemName=ms-vscode.azurecli) extension, gives you extra capabilities, like IntelliSense, and the opportunity to directly run statements from the script file in a terminal window.
25
+
If you're using Visual Studio Code, you can record the command-line statements that you execute in a file with the _.azcli_ extension. This extension, combined with the [Azure CLI Tools](https://marketplace.visualstudio.com/items?itemName=ms-vscode.azurecli) extension, gives you extra capabilities, like IntelliSense, and the opportunity to directly run statements from the script file in a terminal window.
26
26
27
27
With this extension, you can keep a record in an .azcli file of all the steps that you executed and quickly execute these statements through the `Ctrl+` shortcut. To save time and effort in this lab, be sure to check out the extension.
28
28
@@ -39,7 +39,7 @@ There are a couple places in the lab where you can easily to miss steps or incor
39
39
1. Check the logs for the failing application or service.
40
40
41
41
```bash
42
-
az containerapp logs show -g $RESOURCE_GROUP -n <APP_NAME>
42
+
az containerapp logs show -g $RESOURCE_GROUP -n <APP_NAME>
0 commit comments