Skip to content

Variables

We declare numerous variables throughout this workshop. As these modules are lengthy, you will likely complete them over multiple sessions. However, as sessions are additive, they require previously-set variables.

Setting Variables

Execute this script to persist all variables in the current session at any time. We recommend you do this after you complete each module or any other time you are taking a break from the workshop.

Execute this script in the root (e.g. ~\TasksTracker.ContainerApps) to keep setting and updating the same Variables.ps1 file. 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
$file = "./Variables.ps1"
$i = 0
$existingVars = 0

$vars = @(
    "ACA_ENVIRONMENT_SUBNET_ID",
    "API_APP_PORT",
    "APPINSIGHTS_NAME",
    "APPINSIGHTS_INSTRUMENTATIONKEY",
    "AZURE_CONTAINER_REGISTRY_NAME",
    "AZURE_SUBSCRIPTION_ID",
    "BACKEND_API_EXTERNAL_BASE_URL",
    "BACKEND_API_INTERNAL_BASE_URL",
    "BACKEND_API_NAME",
    "BACKEND_API_PRINCIPAL_ID",
    "BACKEND_API_REVISION_NAME",
    "BACKEND_SERVICE_APP_PORT",
    "BACKEND_SERVICE_NAME",
    "BACKEND_SERVICE_PRINCIPAL_ID",
    "BACKEND_SERVICE_REVISION_NAME",
    "COSMOS_DB_ACCOUNT",
    "COSMOS_DB_CONTAINER",
    "COSMOS_DB_DBNAME",
    "COSMOS_DB_ENDPOINT",
    "COSMOS_DB_PRIMARY_MASTER_KEY",
    "ENVIRONMENT",
    "FRONTEND_UI_BASE_URL",
    "FRONTEND_UI_BASE_URL_LOCAL",
    "FRONTEND_WEBAPP_NAME",
    "KEYVAULT_NAME",
    "KEYVAULT_SECRETS_OFFICER_ROLE_ID",
    "KEYVAULT_SECRETS_USER_ROLE_ID",
    "LOCATION",
    "RANDOM_STRING",
    "RESOURCE_GROUP",
    "ROLE_ID",
    "SERVICE_BUS_CONNECTION_STRING",
    "SERVICE_BUS_NAMESPACE_NAME",
    "SERVICE_BUS_TOPIC_NAME",
    "SERVICE_BUS_TOPIC_SUBSCRIPTION",
    "SIGNEDIN_USERID",
    "STORAGE_ACCOUNT_NAME",
    "STORAGE_ACCOUNT_KEY",
    "TARGET_PORT",
    "UI_APP_PORT",
    "VNET_NAME",
    "WORKSPACE_ID",
    "WORKSPACE_NAME",
    "WORKSPACE_SECRET"
);

# Ensure that variables exist in the terminal session. If none exist, we need to prevent accidental wiping of the Variables.ps1 file.
foreach ($var in $vars) {
    if (Test-Path variable:$var) {
        $existingVars++
    }
}

if ($existingVars -eq 0) {
    Write-Host "`nNo variables were found in the current session. Exiting script to prevent accidental overwrite of Variables.ps1 file.`n"
    exit
}

# Now that we know variables exist in the current terminal session, we proceed with writing them to the Variables.ps1 file. We replace
# any existing file with the same name. Note how we intentionally do not use -Append, so that a fresh file gets created here.
"# Execute with `"$file`" to restore previously-saved variables." | Out-File -FilePath $file

foreach ($var in $vars) { 
    # Ensure the variable exists. If not, don't attempt to get it and don't write out a blank value.

    if (Test-Path variable:$var) {
        $val = Get-Variable -Name $var -ValueOnly

        # Powershell 7.4.0 requires a bit more type safety by setting quotes around strings.
        if ($val.GetType().Name -eq "String") {
            $val = "`"$val`""
        }

        "Set-Variable -Scope Global -Name $var -Value $val" | Out-File -FilePath $file -Append
        $i++
    }
}

# $TODAY is a special variable that simply, easily captures today's date.
"Set-Variable -Scope Global -Name TODAY -Value (Get-Date -Format 'yyyyMMdd')" | Out-File -FilePath $file -Append
$i++

# When the Variables.ps1 script executes, the following line will inform how many variables were set in the current session.
"Write-Host `"Set $i variable$($i -eq 1 ? '' : 's').`"" | Out-File -FilePath $file -Append

Write-Host "`nWrote $i variable$($i -eq 1 ? '' : 's') to $file.`n"

Copy this script in the project's root (e.g. $PROJECT_ROOT$). 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
#!/bin/bash

file="./variables.sh"
i=0
existingVars=0

vars=(
    "ACA_ENVIRONMENT_SUBNET_ID"
    "API_APP_PORT"
    "APPINSIGHTS_NAME"
    "APPINSIGHTS_INSTRUMENTATIONKEY"
    "AZURE_CONTAINER_REGISTRY_NAME"
    "AZURE_SUBSCRIPTION_ID"
    "BACKEND_API_EXTERNAL_BASE_URL"
    "BACKEND_API_INTERNAL_BASE_URL"
    "BACKEND_API_NAME"
    "BACKEND_API_PRINCIPAL_ID"
    "BACKEND_API_REVISION_NAME"
    "BACKEND_SERVICE_APP_PORT"
    "BACKEND_SERVICE_NAME"
    "BACKEND_SERVICE_PRINCIPAL_ID"
    "BACKEND_SERVICE_REVISION_NAME"
    "COSMOS_DB_ACCOUNT"
    "COSMOS_DB_CONTAINER"
    "COSMOS_DB_DBNAME"
    "COSMOS_DB_ENDPOINT"
    "COSMOS_DB_PRIMARY_MASTER_KEY"
    "ENVIRONMENT"
    "FRONTEND_UI_BASE_URL"
    "FRONTEND_UI_BASE_URL_LOCAL"
    "FRONTEND_WEBAPP_NAME"
    "KEYVAULT_NAME"
    "KEYVAULT_SECRETS_OFFICER_ROLE_ID"
    "KEYVAULT_SECRETS_USER_ROLE_ID"
    "LOCATION"
    "RANDOM_STRING"
    "RESOURCE_GROUP"
    "ROLE_ID"
    "SERVICE_BUS_CONNECTION_STRING"
    "SERVICE_BUS_NAMESPACE_NAME"
    "SERVICE_BUS_TOPIC_NAME"
    "SERVICE_BUS_TOPIC_SUBSCRIPTION"
    "SIGNEDIN_USERID"
    "STORAGE_ACCOUNT_NAME"
    "STORAGE_ACCOUNT_KEY"
    "TARGET_PORT"
    "UI_APP_PORT"
    "VNET_NAME"
    "WORKSPACE_ID"
    "WORKSPACE_NAME"
    "WORKSPACE_SECRET"
    "PROJECT_ROOT"
)

# Ensure that variables exist in the terminal session. If none exist, we need to prevent accidental wiping of the Variables.sh file.
for var in "${vars[@]}"; do
    if [[ -v $var ]]; then
        ((existingVars++))
    fi
done

if [[ $existingVars -eq 0 ]]; then
    echo -e "\nNo variables were found in the current session. Exiting script to prevent accidental overwrite of Variables.sh file.\n"
    exit
fi

# Now that we know variables exist in the current terminal session, we proceed with writing them to the Variables.sh file. We replace
# any existing file with the same name. Note how we intentionally do not use >>, so that a fresh file gets created here.
echo "# Execute with \". $file\" to restore previously-saved variables." > $file

for var in "${vars[@]}"; do
    # Ensure the variable exists. If not, don't attempt to get it and don't write out a blank value.
    if [[ -v $var ]]; then
        val=${!var}

        # Bash requires a bit more type safety by setting quotes around strings.
        if [[ $val =~ ^[0-9]+$ ]]; then
            echo "export $var=$val" >> $file
        else
            echo "export $var=\"$val\"" >> $file
        fi
        ((i++))
    fi
done

# $TODAY is a special variable that simply, easily captures today's date.
echo "export TODAY=$(date +%Y%m%d)" >> $file
((i++))

# When the Variables.sh script executes, the following line will inform how many variables were set in the current session.
echo "# Set $i variable(s)." >> $file
echo "Wrote $i variable(s) to $file."
Make the script executable and execute it to keep setting and updating the same variables.sh file. 
1
2
chmod +x ./set_variables.sh
./set_variables.sh

Restoring Variables

The output of the Set-Variables.ps1 script is stored in the same directory where you execute that script. You can quickly apply those variables and get back to a working state by executing .\Variables.ps1 in your PowerShell console. This is useful after having taken a break from the workshop and losing the session or when you are asked to open a second session such as when you are running multiple microservices locally with dapr.

The output of the set_variables.sh script is stored in the same directory where you execute that script. You can quickly apply those variables and get back to a working state by executing . ./variables.sh in your shell console. This is useful after having taken a break from the workshop and losing the session or when you are asked to open a second session such as when you are running multiple microservices locally with dapr.