web.config 변환

아티클
11/06/2024

참고 항목

이 문서의 최신 버전은 아닙니다. 현재 릴리스는 이 문서의 .NET 9 버전을 참조 하세요.

Warning

이 버전의 ASP.NET Core는 더 이상 지원되지 않습니다. 자세한 내용은 .NET 및 .NET Core 지원 정책을 참조 하세요. 현재 릴리스는 이 문서의 .NET 9 버전을 참조 하세요.

Important

이 정보는 상업적으로 출시되기 전에 실질적으로 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적, 또는 묵시적인 보증을 하지 않습니다.

현재 릴리스는 이 문서의 .NET 9 버전을 참조 하세요.

작성자: Vijay Ramakrishnan

다음을 기반으로 앱을 게시할 때 web.config 파일의 변환을 자동으로 적용할 수 있습니다.

빌드 구성
프로필
환경
사용자 지정

이 변환은 다음 web.config 생성 시나리오 중 하나에 대해 발생합니다.

Microsoft.NET.Sdk.Web SDK에서 자동으로 생성되는 경우
앱의 콘텐츠 루트에서 개발자가 제공하는 경우

빌드 구성

빌드 구성 변환이 먼저 실행됩니다.

web.config 변환이 필요한 각 빌드 구성(Debug|Release)에 사용할 web.{CONFIGURATION}.config 파일을 포함합니다.

다음 예제에서는 구성별 환경 변수가 web.Release.config에서 설정됩니다.

<?xml version="1.0"?>
<configuration xmlns:xdt="http://schemas.microsoft.com/XML-Document-Transform">
  <location>
    <system.webServer>
      <aspNetCore>
        <environmentVariables xdt:Transform="InsertIfMissing">
          <environmentVariable name="Configuration_Specific" 
                               value="Configuration_Specific_Value" 
                               xdt:Locator="Match(name)" 
                               xdt:Transform="InsertIfMissing" />
        </environmentVariables>
      </aspNetCore>
    </system.webServer>
  </location>
</configuration>

구성이 Release로 설정되면 변환이 적용됩니다.

dotnet publish --configuration Release

구성의 MSBuild 속성은 $(Configuration)입니다.

프로필

프로필 변환은 빌드 구성 변환 후에 두 번째로 실행됩니다.

web.config 변환이 필요한 각 프로필 구성에 사용할 web.{PROFILE}.config 파일을 포함합니다.

다음 예제에서는 프로필별 환경 변수가 폴더 게시 프로필에 대한 web.FolderProfile.config에서 설정됩니다.

<?xml version="1.0"?>
<configuration xmlns:xdt="http://schemas.microsoft.com/XML-Document-Transform">
  <location>
    <system.webServer>
      <aspNetCore>
        <environmentVariables xdt:Transform="InsertIfMissing">
          <environmentVariable name="Profile_Specific" 
                               value="Profile_Specific_Value" 
                               xdt:Locator="Match(name)" 
                               xdt:Transform="InsertIfMissing" />
        </environmentVariables>
      </aspNetCore>
    </system.webServer>
  </location>
</configuration>

프로필이 FolderProfile인 경우 변환이 적용됩니다.

dotnet publish --configuration Release /p:PublishProfile=FolderProfile

프로필 이름의 MSBuild 속성은 $(PublishProfile)입니다.

프로필이 전달되지 않으면 기본 프로필 이름은 FileSystem이고, 파일이 앱의 콘텐츠 루트에 있으면 web.FileSystem.config가 적용됩니다.

Environment

환경 변환은 빌드 구성 및 프로필 변환 후에 세 번째로 실행됩니다.

web.config 변환이 필요한 각 환경에 사용할 web.{ENVIRONMENT}.config 파일을 포함합니다.

다음 예제에서는 환경별 환경 변수가 프로덕션 환경의 web.Production.config에서 설정됩니다.

<?xml version="1.0"?>
<configuration xmlns:xdt="http://schemas.microsoft.com/XML-Document-Transform">
  <location>
    <system.webServer>
      <aspNetCore>
        <environmentVariables xdt:Transform="InsertIfMissing">
          <environmentVariable name="Environment_Specific" 
                               value="Environment_Specific_Value" 
                               xdt:Locator="Match(name)" 
                               xdt:Transform="InsertIfMissing" />
        </environmentVariables>
      </aspNetCore>
    </system.webServer>
  </location>
</configuration>

환경이 Production인 경우 변환이 적용됩니다.

dotnet publish --configuration Release /p:EnvironmentName=Production

환경의 MSBuild 속성은 $(EnvironmentName)입니다.

Visual Studio에서 게시 프로필을 사용하여 게시하는 경우 ASP.NET Core 앱 배포용 Visual Studio 게시 프로필(.pubxml)을 참조하세요.

환경 이름이 지정되면 ASPNETCORE_ENVIRONMENT 환경 변수가 web.config 파일에 자동으로 추가됩니다.

사용자 지정

사용자 지정 변환은 빌드 구성, 프로필 및 환경 변환 후에 마지막으로 실행됩니다.

web.config 변환이 필요한 각 사용자 지정 구성에 사용할 {CUSTOM_NAME}.transform 파일을 포함합니다.

다음 예제에서는 사용자 지정 변환 환경 변수가 custom.transform에서 설정됩니다.

<?xml version="1.0"?>
<configuration xmlns:xdt="http://schemas.microsoft.com/XML-Document-Transform">
  <location>
    <system.webServer>
      <aspNetCore>
        <environmentVariables xdt:Transform="InsertIfMissing">
          <environmentVariable name="Custom_Specific" 
                               value="Custom_Specific_Value" 
                               xdt:Locator="Match(name)" 
                               xdt:Transform="InsertIfMissing" />
        </environmentVariables>
      </aspNetCore>
    </system.webServer>
  </location>
</configuration>

CustomTransformFileName 속성이 dotnet publish 명령에 전달되면 변환이 적용됩니다.

dotnet publish --configuration Release /p:CustomTransformFileName=custom.transform

프로필 이름의 MSBuild 속성은 $(CustomTransformFileName)입니다.