App Service 앱 구성

1. Azure Portal에서 App Services를 검색하여 선택한 다음, 앱을 선택합니다.

2. 앱의 왼쪽 메뉴에서 설정>환경 변수를 선택합니다. 그런 다음 , 앱 설정을 선택합니다.

   

   기본값으로 앱 설정의 값은 보안을 위해 포털에서 숨겨집니다. 앱 설정의 숨겨진 값을 보려면 값 아래에서 값 표시를 선택합니다. 모든 앱 설정의 숨겨진 값을 보려면 값 표시를 선택합니다.

   참고

   Azure Portal에서 이 섹션을 보려면 읽기/쓰기 사용자 권한이 필요합니다. 충분한 권한이 있는 RBAC 내장 역할은 소유자, 기여자 및 웹사이트 기여자입니다. 읽기 권한자 역할만으로는 이 페이지에 액세스할 수 없습니다.

3. 새 앱 설정을 추가하려면 추가를 선택합니다. 설정을 편집하려면 설정을 선택합니다.

4. 대화 상자에서 설정을 현재 슬롯에 고정할 수 있습니다.

   참고

   기본 Linux 앱 서비스 또는 사용자 지정 Linux 컨테이너에서는 앱 설정 이름의 중첩된 JSON 키 구조를 키 이름에 대해 다르게 구성해야 합니다. 모든 콜론(:)을 이중 밑줄(__)로 대체합니다. 모든 마침표(.)를 단일 밑줄(_)로 바꿉니다. 예를 들어 App Service에서 ApplicationInsights:InstrumentationKey를 키 이름으로서 ApplicationInsights__InstrumentationKey로 구성해야 합니다.

5. 완료되면 적용을 선택합니다. 그런 다음, 환경 변수 페이지에서 적용을 선택합니다.

az webapp config app settings set을 사용하여 앱 설정을 추가하거나 편집합니다.

az webapp config appsettings set --resource-group <group-name> --name <app-name> --settings <setting-name>="<value>"

설정의 이름으로 <setting-name>을(를) 바꾸십시오. 설정에 할당할 값으로 <value>를 바꾸십시오.

az webapp config appsettings 목록을 사용하여 모든 설정 및 해당 값을 표시합니다.

az webapp config appsettings list --resource-group <group-name> --name <app-name>

az webapp config app settings delete를 사용하여 하나 이상의 설정을 제거합니다.

az webapp config appsettings delete --resource-group <group-name> --name <app-name> --setting-names {<setting-name1>,<setting-name2>,...}

Set-AzWebApp을 사용하여 하나 이상의 앱 설정을 지정합니다.

Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -AppSettings @{"<setting-name1>"="<value1>"; "<setting-name2>"="<value2>";...}

이 cmdlet은 앱 설정의 전체 집합을 사용자가 지정한 설정으로 바꿉니다. 기존 집합 내에서 앱 설정을 추가하거나 편집하려면 Get-AzWebApp cmdlet을 사용하여 입력 해시 테이블에 기존 앱 설정을 포함합니다. 예시:

# Get app configuration
$webapp=Get-AzWebApp -ResourceGroupName <group-name> -Name <app-name>

# Copy app settings to a new hash table
$appSettings = @{}
ForEach ($item in $webapp.SiteConfig.AppSettings) {
$appSettings[$item.Name] = $item.Value
}

# Add or edit one or more app settings
$appSettings['<setting-name1>'] = '<value1>'
$appSettings['<setting-name2>'] = '<value2>'

# Save changes
Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -AppSettings $appSettings

앱 설정이 슬롯별인지 확인하려면 Get-AzWebAppSlotConfigName을 사용합니다.

Get-AzWebAppSlotConfigName -ResourceGroupName <group-name> -Name <app-name> | select AppSettingNames

하나 이상의 앱 설정 슬롯을 구체적으로 지정하려면 Set-AzWebAppSlotConfigName을 사용합니다.

Set-AzWebAppSlotConfigName -ResourceGroupName <group-name> -Name <app-name> -AppSettingNames <setting-name1>,<setting-name2>,...

1. 고급 편집을 선택합니다.
2. 텍스트 영역에서 설정을 편집합니다.
3. 완료하면 확인을 선택합니다. 그런 다음, 환경 변수 페이지에서 적용을 선택합니다.

앱 설정에는 다음과 같은 JSON 형식이 있습니다.

[
  {
    "name": "<key-1>",
    "value": "<value-1>",
    "slotSetting": false
  },
  {
    "name": "<key-2>",
    "value": "<value-2>",
    "slotSetting": false
  },
  ...
]

JSON 파일의 이름으로 설정된 az webapp config 앱 설정을 실행합니다.

az webapp config appsettings set --resource-group <group-name> --name <app-name> --settings "@fileName.json"

필요한 파일 형식은 슬롯 설정 필드가 선택 사항인 설정의 JSON 배열입니다. 예시:

[
  {
    "name": "key1",
    "slotSetting": false,
    "value": "value1"
  },
  {
    "name": "key2",
    "value": "value2"
  }
]

편의를 위해 az webapp config appsettings 목록을 사용하여 JSON 파일에 기존 설정을 저장할 수 있습니다.

# Save the settings
az webapp config appsettings list --resource-group <group-name> --name <app-name>  > settings.json

# Edit the JSON file
...

# Update the app with the JSON file
az webapp config appsettings set --resource-group <group-name> --name <app-name> --settings @settings.json

Azure PowerShell에서 JSON 파일을 사용하여 앱 설정을 대량으로 편집할 수 없습니다.

1. Azure Portal에서 App Services를 검색하여 선택한 다음, 앱을 선택합니다.

2. 앱의 왼쪽 메뉴에서 설정>환경 변수를 선택합니다. 그런 다음 연결 문자열을 선택합니다.

   기본값으로 연결 문자열의 값은 보안을 위해 포털에서 숨겨집니다. 연결 문자열의 숨겨진 값을 보려면 값 아래에서 값 표시를 선택합니다. 모든 연결 문자열의 숨겨진 값을 보려면 값 표시를 선택합니다.

3. 새 연결 문자열을 추가하려면 추가를 선택합니다. 연결 문자열을 편집하려면 연결 문자열을 선택합니다.

4. 대화 상자에서 연결 문자열을 현재 슬롯에 고정할 수 있습니다.

5. 완료되면 적용을 선택합니다. 그런 다음, 환경 변수 페이지에서 적용을 선택합니다.

az webapp config connection-string set를 사용하여 앱 설정을 추가하거나 편집합니다.

az webapp config connection-string set --resource-group <group-name> --name <app-name> --connection-string-type <type> --settings <string-name>='<value>'

<string-name>를 연결 문자열의 이름으로 바꾸십시오. <value>을(를) 연결 문자열에 할당할 값으로 바꿉니다. <type>와 같은 SQLAzure의 가능한 값은 CLI 명령 설명서를 참조하세요.

az webapp config connection-string list를 사용하여 모든 연결 문자열 및 해당 값을 표시합니다.

az webapp config connection-string list --resource-group <group-name> --name <app-name>

az webapp config connection-string delete를 사용하여 하나 이상의 연결 문자열을 제거합니다.

az webapp config connection-string delete --resource-group <group-name>  --name <app-name>--setting-names {<string-name1>,<string-name2>,...}

Set-AzWebApp을 사용하여 하나 이상의 연결 문자열을 설정합니다.

$PropertiesObject = @{
  "<string-name1>" = @{
    value="<connection-string1>";
    type="<type>"};
  "<string-name2>" = @{
    value="<connection-string2>";
    type="<type>"}
}

Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -ConnectionStrings $PropertiesObject

각 연결 문자열에는 이름(<string-name1>), 값(<connection-string1>) 및 형식이 포함됩니다. 형식은 ConnectionStringType 열거자 필드 중 하나에 해당하는 숫자 값입니다. 예를 들어 Azure SQL의 경우, type="2"를 지정하십시오.

이 cmdlet은 전체 연결 문자열 집합을 지정한 문자열로 바꿉니다. 기존 집합 내에서 앱 설정을 추가하거나 편집하려면 Get-AzWebApp cmdlet을 사용하여 입력 해시 테이블에 기존 앱 설정을 포함합니다. 예시:

# Get app configuration
$webapp=Get-AzWebApp -ResourceGroupName <group-name> -Name <app-name>

# Copy connection strings to a new hash table
$connStrings = @{}
ForEach ($item in $webapp.SiteConfig.ConnectionStrings) {
    $connStrings[$item.Name] = @{value=$item.ConnectionString; type=$item.Type.ToString()}
}

# Add or edit one or more connection strings
$connStrings['<string-name1>'] = @{value='<connection-string1>'; type='<type>'}
$connStrings['<string-name2>'] = @{value='<connection-string2>'; type='<type>'}

# Save changes
Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -ConnectionStrings $connStrings

연결 문자열이 슬롯에 특정되어 있는지 확인하려면 Get-AzWebAppSlotConfigName을 사용합니다.

Get-AzWebAppSlotConfigName -ResourceGroupName <group-name> -Name <app-name> | select ConnectionStringNames

하나 이상의 연결 문자열 슬롯을 구체적으로 지정하려면 Set-AzWebAppSlotConfigName을 사용합니다.

Set-AzWebAppSlotConfigName -ResourceGroupName <group-name> -Name <app-name> -ConnectionStringNames <string-name1>,<string-name2>,...

1. 고급 편집을 선택합니다.
2. 텍스트 영역에서 연결 문자열을 편집합니다.
3. 완료되면 적용을 선택합니다. 환경 변수 페이지에서 적용을 선택해야 합니다.

연결 문자열의 JSON 형식은 다음과 같습니다.

[
  {
    "name": "name-1",
    "value": "conn-string-1",
    "type": "SQLServer",
    "slotSetting": false
  },
  {
    "name": "name-2",
    "value": "conn-string-2",
    "type": "PostgreSQL",
    "slotSetting": false
  },
  ...
]

JSON 파일의 이름으로 az webapp config connection-string set 을 실행합니다.

az webapp config connection-string set --resource-group <group-name> --name <app-name> --settings "@fileName.json"

필요한 파일 형식은 슬롯 설정 필드가 선택 사항인 연결 문자열의 JSON 배열입니다. 예시:

[
  {
    "name": "name-1",
    "value": "conn-string-1",
    "type": "SQLServer",
    "slotSetting": false
  },
  {
    "name": "name-2",
    "value": "conn-string-2",
    "type": "PostgreSQL",
  },
  ...
]

편의를 위해 az webapp config connection-string 목록을 사용하여 JSON 파일에 기존 연결 문자열을 저장할 수 있습니다.

# Save the connection strings
az webapp config connection-string list --resource-group <group-name> --name <app-name> > settings.json

# Edit the JSON file
...

# Update the app with the JSON file
az webapp config connection-string set --resource-group <group-name> --name <app-name> --settings @settings.json

Azure PowerShell에서 JSON 파일을 사용하여 연결 문자열을 대량으로 편집할 수 없습니다.

1. Azure Portal에서 App Services를 검색하여 선택한 다음, 앱을 선택합니다.

2. 앱의 왼쪽 메뉴에서 설정>구성을 선택합니다. 그런 다음 일반 설정을 선택합니다.

   

여기에서 앱에 대한 몇 가지 일반 설정을 구성할 수 있습니다. 일부 설정에서는 더 높은 가격 책정 계층으로 스케일 업해야 합니다.

• 스택 설정: 언어 및 SDK 버전을 포함하여 앱을 실행하도록 소프트웨어 스택에 대한 설정을 구성합니다.

  Linux 앱의 경우 언어 런타임 버전을 선택하고 선택적 시작 명령을 설정할 수 있습니다.

• 플랫폼 설정: 다음을 포함하여 호스팅 플랫폼에 대한 설정을 구성합니다.

  • 플랫폼: 32비트 또는 64비트 선택 Windows 앱에만 해당합니다.

  • FTP 상태: FTPS만 허용하거나 FTP를 모두 사용하지 않도록 설정합니다.

  • HTTP 버전: HTTPS/2 프로토콜에 대한 지원을 사용하도록 설정하려면 2.0으로 설정합니다.

    참고

    대부분의 최신 브라우저는 TLS를 통한 HTTP/2 프로토콜만 지원합니다. 암호화되지 않은 트래픽은 HTTP/1.1을 계속 사용합니다. 클라이언트 브라우저가 HTTP/2를 사용하여 앱에 연결되도록 하려면 사용자 지정 DNS 이름을 보호합니다. 자세한 내용은 App Service에서 TLS/SSL 바인딩을 사용하여 사용자 지정 DNS 이름에 대한 보안 제공을 참조하세요.

  • 웹 소켓: 예를 들어 ASP.NET SignalR 또는 socket.io 대해 구성합니다.

  • Always On: 트래픽이 없는 경우에도 앱을 로드된 상태로 유지하려면 켭니다.

    Always On이 꺼지면(기본값) 들어오는 요청 없이 20분 후에 앱이 언로드됩니다. 언로드된 앱은 준비 시간 때문에 새 요청에 대해 대기 시간이 길어질 수 있습니다.

    Always On이 켜지면 프런트 엔드 부하 분산 장치는 5분마다 애플리케이션 루트에 요청을 보냅니 GET 다. 연속 ping은 앱이 언로드될 수 없도록 방지합니다.

    연속적으로 실행되는 웹 작업 또는 cron 식으로 실행되는 웹 작업에는 Always On이 필요합니다.

  • 세션 선호도: 다중 인스턴스 배포에서 클라이언트가 세션 수명 동안 동일한 인스턴스로 라우팅되는지 확인합니다. 상태 비저장 애플리케이션의 경우 이 옵션을 Off로 설정할 수 있습니다.

  • 세션 고정 프록시: 앱이 역방향 프록시 뒤에 있고 (예: Azure Application Gateway 또는 Azure Front Door) 기본 호스트 이름을 사용하는 경우 켜십시오. 세션 선호도 쿠키의 도메인은 역방향 프록시의 전달된 호스트 이름과 일치합니다.

  • HTTPS 전용: 모든 HTTP 트래픽을 HTTPS로 리디렉션하려는 경우 사용하도록 설정합니다.

  • 최소 TLS 버전: 앱에 필요한 최소 TLS 암호화 버전을 선택합니다.

• 디버깅: ASP.NET, ASP.NET Core, Node.js 앱에 대해 원격 디버깅을 사용하도록 설정합니다. 이 옵션은 48시간 후에 자동으로 해제됩니다.

• 들어오는 클라이언트 인증서: 상호 인증에 클라이언트 인증서가 필요합니다.

az webapp config set를 사용하여 많은 일반적인 구성 가능한 옵션을 설정할 수 있습니다. 다음 예제에서는 구성 가능한 옵션의 하위 집합을 보여 줍니다.

az webapp config set --resource-group <group-name> --name <app-name>  --use-32bit-worker-process [true|false] --web-sockets-enabled [true|false] --always-on [true|false]--http20-enabled --auto-heal-enabled [true|false] --remote-debugging-enabled [true|false] --number-of-workers

기존 설정을 표시하려면 az webapp config show 명령을 사용합니다.

Set-AzWebApp을 사용하여 많은 일반적인 구성 가능한 옵션을 설정할 수 있습니다. 다음 예제에서는 구성 가능한 옵션의 하위 집합을 보여 줍니다.

Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -Use32BitWorkerProcess [$True|$False] -WebSocketsEnabled [$True|$False] -AlwaysOn [$True|$False] -NumberOfWorkers

기존 설정을 표시하려면 Get-AzWebApp 명령을 사용합니다.

1. Azure Portal에서 App Services를 검색하여 선택한 다음, 앱을 선택합니다.
2. 앱의 왼쪽 메뉴에서 구성을 선택합니다. 그런 다음 , 기본 문서를 선택합니다.
3. 기본 문서를 추가하려면 새 문서를 선택합니다. 기본 문서를 제거하려면 오른쪽에 있는 삭제를 선택합니다.

az resource update를 사용하여 기본 문서를 추가합니다.

az resource update --resource-group <group-name> --resource-type "Microsoft.Web/sites/config" --name <app-name>/config/web --add properties.defaultDocuments <filename>

업데이트 앱의 PowerShell 개체를 수정하여 기본 문서를 추가합니다.

$webapp = Get-AzWebApp -ResourceGroupName <group-name> -Name <app-name>
$webapp.SiteConfig.DefaultDocuments.Add("<filename>")
Set-AzWebApp $webapp

1. Azure Portal에서 App Services를 검색하여 선택한 다음, 앱을 선택합니다.

2. 앱의 왼쪽 메뉴에서 설정>구성을 선택합니다. 그런 다음 경로 매핑을 선택합니다.

3. 새 가상 애플리케이션 또는 디렉터리를 선택합니다. 그런 다음, 다음 작업 중 하나를 수행합니다.

   • 가상 디렉터리를 실제 경로에 매핑하려면 디렉터리를 선택된 상태로 둡니다. 가상 디렉터리 및 웹 사이트 루트(D:\home)에 대한 해당 상대(실제) 경로를 지정합니다.
   • 가상 디렉터리를 웹 애플리케이션으로 표시하려면 디렉터리를 선택 취소합니다.

   

4. 확인선택합니다. 그런 다음 구성 페이지에서 저장을 선택합니다.

다음 예제에서는 / 루트 경로를 public 하위 디렉터리에 설정하여 Laravel에 적합하도록 합니다. 또한 경로에 두 번째 가상 애플리케이션을 추가합니다 /app2 . 실행하려면 다음 내용을 포함하는 json.txt 파일을 만드세요.

[
  {
    "physicalPath"':' "site\\wwwroot\\public",
    "preloadEnabled"':' false,
    "virtualDirectories"':' null,
    "virtualPath"':' "/"
  },
  {
    "physicalPath"':' "site\\wwwroot\\app2",
    "preloadEnabled"':' false,
    "virtualDirectories"':' null,
    "virtualPath"':' "/app2"
  }
]

리소스에 대해 <group-name> 및 <app-name>을 변경하고 다음 명령을 실행합니다. 이 명령을 실행할 때는 이스케이프 문자에 유의하세요. 이스케이프 문자에 대한 자세한 내용은 Azure CLI를 성공적으로 사용하기 위한 팁을 참조하세요.

az resource update --resource-group <group-name> --resource-type Microsoft.Web/sites/config --name <app-name>/config/web --set properties.virtualApplications="@json.txt"

다음 예제에서는 / 루트 경로를 public 하위 디렉터리에 설정하여 Laravel에 적합하도록 합니다. 또한 경로에 두 번째 가상 애플리케이션을 추가합니다 /app2 . 실행하려면 <group-name> 및 <app-name>을 변경합니다.

$webapp=Get-AzWebApp -ResourceGroupName <group-name> -Name <app-name>

# Set default / path to public subdirectory
$webapp.SiteConfig.VirtualApplications[0].PhysicalPath= "site\wwwroot\public"

# Add a virtual application
$virtualApp = New-Object Microsoft.Azure.Management.WebSites.Models.VirtualApplication
$virtualApp.VirtualPath = "/app2"
$virtualApp.PhysicalPath = "site\wwwroot\app2"
$virtualApp.PreloadEnabled = $false
$webapp.SiteConfig.VirtualApplications.Add($virtualApp)

# Save settings
Set-AzWebApp $webapp