Copy Files From Source Repo (2025-02-25 19:35)

Author: olprod

Instructions/Labs/AZ400_M02_L04_Enable_Continuous_Integration_with_Azure_Pipelines.md

@@ -6,8 +6,6 @@ lab:
 
 # Azure Pipelines과의 연속 통합 지원
 
-## 학생용 랩 매뉴얼
-
 ## 랩 요구 사항
 
 - 이 랩은 **Microsoft Edge** 또는 [Azure DevOps 지원 브라우저](https://docs.microsoft.com/azure/devops/server/compatibility)가 필요합니다.
@@ -29,11 +27,11 @@ lab:
 - 끌어오기 요청의 일부로 빌드 유효성 검사를 포함합니다.
 - YAML을 사용하여 CI 파이프라인을 코드로 구성합니다.
 
-## 예상 소요 시간: 45분
+## 예상 소요 시간: 30분
 
 ## 지침
 
-### 연습 0: 랩 필수 구성 요소 구성
+### 연습 0: (완료된 경우 건너뛰기)랩 필수 구성 요소 구성
 
 이 연습에서는 랩의 필수 구성 요소를 설정합니다. 구체적으로는 [eShopOnWeb](https://github.com/MicrosoftLearning/eShopOnWeb)을 기반으로 하여 새 Azure DevOps 프로젝트와 리포지토리를 설정합니다.
 
@@ -47,7 +45,7 @@ lab:
 
 이 작업에서는 여러 랩에서 사용할 eShopOnWeb Git 리포지토리를 가져옵니다.
 
-1. 랩 컴퓨터의 브라우저 창에서 Azure DevOps 조직 및 이전에 만든 **eShopOnWeb** 프로젝트를 엽니다. **Repos > 파일**, **리포지토리 가져오기**를 클릭합니다. **가져오기**를 선택합니다. **Git 리포지토리 가져오기** 창에서 다음 URL https://github.com/MicrosoftLearning/eShopOnWeb.git을 붙여넣고 **가져오기**를 클릭합니다.
+1. 랩 컴퓨터의 브라우저 창에서 Azure DevOps 조직 및 이전에 만든 **eShopOnWeb** 프로젝트를 엽니다. **Repos > 파일**, **리포지토리 가져오기**를 클릭합니다. **가져오기**를 선택합니다. **Git 리포지토리 가져오기** 창에서 다음 URL <https://github.com/MicrosoftLearning/eShopOnWeb.git>을 붙여넣고 **가져오기**를 클릭합니다.
 
 1. 리포지토리는 다음과 같은 방식으로 구성됩니다.
     - **.ado** 폴더에는 Azure DevOps YAML 파이프라인이 포함되어 있습니다.
@@ -58,7 +56,7 @@ lab:
 
 #### 작업 3: (완료된 경우 건너뛰기) 기본(main) 분기를 기본 분기로 설정
 
-1. **Repos > 분기**로 이동합니다.
+1. **Repos > Branches**로 이동합니다.
 1. **기본** 분기를 마우스로 가리킨 다음 열 오른쪽에 있는 줄임표를 클릭합니다.
 1. **기본 분기로 설정**을 클릭합니다.
 
@@ -72,7 +70,7 @@ lab:
 
 먼저 [eshoponweb-ci-pr.yml](https://github.com/MicrosoftLearning/eShopOnWeb/blob/main/.ado/eshoponweb-ci-pr.yml)이라는 빌드 파이프라인을 가져오겠습니다.
 
-1. **파이프라인 > 파이프라인**으로 이동합니다.
+1. **Pipelines > Pipelines**로 이동합니다.
 1. **파이프라인 만들기** 또는 **새 파이프라인 만들기** 단추를 클릭합니다.
 1. **Azure Repos Git(YAML)** 을 선택합니다.
 1. **eShopOnWeb** 리포지토리를 선택합니다.
@@ -86,13 +84,13 @@ lab:
     - **DotNet Publish**: 호스팅 시스템에 배포하기 위해 애플리케이션 및 해당 종속성을 폴더에 게시합니다. 이 경우 **Build.ArtifactStagingDirectory**입니다.
 
 1. **저장** 단추를 클릭하여 파이프라인 정의를 저장합니다.
-1. 파이프라인은 프로젝트 이름을 기준으로 이름을 사용합니다. 파이프라인을 더 잘 식별하기 위해 **이름을 바꿔**보겠습니다. **파이프라인 > 파이프라인으로** 이동하여 최근에 만든 파이프라인을 클릭합니다. 줄임표 및 **이름 바꾸기/이동** 옵션을 클릭합니다. 이름을 **eshoponweb-ci-pr**로 설정하고 **저장**을 클릭합니다.
+1. 파이프라인은 프로젝트 이름을 기준으로 이름을 사용합니다. 파이프라인을 더 잘 식별하기 위해 **이름을 바꿔**보겠습니다. **Pipelines > Pipelines**로 이동하여 최근에 만든 파이프라인을 클릭합니다. 줄임표 및 **이름 바꾸기/이동** 옵션을 클릭합니다. 이름을 **eshoponweb-ci-pr**로 설정하고 **저장**을 클릭합니다.
 
 #### 작업 2: 분기 정책
 
 이 작업에서는 기본 분기에 정책을 추가하며, 정의된 정책을 준수하는 끌어오기 요청을 사용하는 변경 내용만 허용합니다. 분기의 변경 내용을 병합하기 전에 해당 변경 내용을 검토하려 합니다.
 
-1. **리포지토리 > 분기** 섹션으로 이동합니다.
+1. **Repos > 분기** 섹션으로 이동합니다.
 1. **분기** 창의 **내 항목** 탭에서 **main** 분기 항목 위에 마우스 포인터를 올리면 오른쪽에 줄임표 기호가 표시됩니다.
 1. 줄임표를 클릭하고 팝업 메뉴에서 **분기 정책**을 선택합니다.
 1. 리포지토리 설정의 **main** 탭에서 **최소 검토자 수 필요** 옵션을 사용하도록 설정합니다. 검토자 **1**명을 추가하고 **요청자가 자신의 변경 내용을 승인할 수 있음**(현재 수강생 본인이 랩 프로젝트의 유일한 사용자이므로) 확인란을 선택합니다.
@@ -132,7 +130,7 @@ lab:
 
 먼저 [eshoponweb-ci.yml](https://github.com/MicrosoftLearning/eShopOnWeb/blob/main/.ado/eshoponweb-ci.yml)이라는 CI 파이프라인을 가져오겠습니다.
 
-1. **Pipelines>Pipelines**로 이동합니다.
+1. **Pipelines > Pipelines**로 이동합니다.
 1. **새 파이프라인** 단추를 클릭합니다.
 1. **Azure Repos Git(YAML)** 을 선택합니다.
 1. **eShopOnWeb** 리포지토리를 선택합니다.
@@ -147,6 +145,8 @@ lab:
     - **Publish Artifact - Website**: 이전 단계에서 만든 앱 아티팩트를 게시하고 파이프라인 아티팩트로 사용할 수 있도록 합니다.
     - **Publish Artifact - Bicep**: 인프라 아티팩트(Bicep 파일)를 게시하고 파이프라인 아티팩트로 사용할 수 있도록 합니다.
 
+1. **실행**을 클릭하고 파이프라인이 성공적으로 실행될 때까지 기다립니다.
+
 #### 작업 2: 연속 통합 사용
 
 기본 빌드 파이프라인 정의는 연속 통합을 사용하도록 설정하지 않습니다.
@@ -168,11 +168,11 @@ lab:
 
     분기 정책을 사용하도록 설정했기 때문에 코드를 업데이트하려면 끌어오기 요청을 전달해야 합니다.
 
-1. **저장** 단추(**저장 및 실행** 아님)를 클릭하여 파이프라인 정의를 저장합니다.
+1. **유효성 검사 및 저장** 단추를 클릭하여 파이프라인 정의의 유효성을 검사하고 저장합니다.
 1. **이 커밋의 새 분기 만들기**를 선택합니다.
 1. 기본 분기 이름을 그대로 사용하고 **끌어오기 요청 시작**을 선택된 상태로 유지합니다.
 1. **Save**를 클릭합니다.
-1. 파이프라인은 프로젝트 이름을 기준으로 이름을 사용합니다. 파이프라인을 더 잘 식별하기 위해 **이름을 바꿔**보겠습니다. **파이프라인 > 파이프라인으로** 이동하여 최근에 만든 파이프라인을 클릭합니다. 줄임표 및 **이름 바꾸기/이동** 옵션을 클릭합니다. 이름을 **eshoponweb-ci**로 설정하고 **저장**을 클릭합니다.
+1. 파이프라인은 프로젝트 이름을 기준으로 이름을 사용합니다. 파이프라인을 더 잘 식별하기 위해 **이름을 바꿔**보겠습니다. **Pipelines > Pipelines**로 이동하여 최근에 만든 파이프라인을 클릭합니다. 줄임표 및 **이름 바꾸기/이동** 옵션을 클릭합니다. 이름을 **eshoponweb-ci**로 설정하고 **저장**을 클릭합니다.
 1. **리포지토리 > 끌어오기 요청**으로 이동합니다.
 1. **"Azure Pipelines에 대한 eshoponweb-ci.yml 업데이트"** 끌어오기 요청을 클릭합니다.
 1. 모든 유효성 검사가 성공하면 오른쪽 위에 있는 **승인**을 클릭합니다. 이제 **완료**를 클릭할 수 있습니다.
@@ -182,7 +182,7 @@ lab:
 
 이 작업에서는 새 분기를 사용하여 끌어오기 요청을 만들어 변경 내용을 보호된 **기본** 분기에 병합하고 CI 파이프라인을 자동으로 트리거합니다.
 
-1. **리포지토리** 섹션으로 이동합니다.
+1. **Repos** 섹션으로 이동하여 **분기**를 클릭합니다.
 1. **main** 분기를 기반으로 **Feature02**라는 새 분기를 만듭니다.
 1. 새 **Feature02** 분기를 클릭합니다.
 1. **/eShopOnWeb/src/Web/Program.cs** 파일로 이동하고 오른쪽 위에서 **편집**을 클릭합니다.
@@ -199,7 +199,7 @@ lab:
 1. 대상 **main** 분기에 적용된 정책에 따라, 끌어오기 요청에는 몇 가지 보류 중인 요구 사항이 표시됩니다.
 1. 모든 유효성 검사가 성공하면 오른쪽 위에 있는 **승인**을 클릭합니다. 이제 **자동 완성 설정** 드롭다운에서 **완료**를 클릭할 수 있습니다.
 1. **끌어오기 요청 완료** 탭에서 **병합 완료**를 클릭합니다.
-1. **Pipelines>Pipelines**로 돌아가면 코드가 병합된 후 **eshoponweb-ci** 빌드가 자동으로 트리거된 것을 알 수 있습니다.
+1. **Pipelines > Pipelines**로 돌아가면 코드가 병합된 후 **eshoponweb-ci** 빌드가 자동으로 트리거된 것을 확인할 수 있습니다.
 1. **eshoponweb-ci** 빌드를 클릭한 다음 마지막 실행을 선택합니다.
 1. 성공적으로 실행된 후 **관련 항목 > 게시됨**을 클릭하여 게시된 아티팩트를 검사합니다.
     - Bicep: 인프라 아티팩트입니다.

Instructions/Labs/AZ400_M07_L13_Package_Management_with_Azure_Artifacts.md

@@ -145,23 +145,23 @@ Azure Artifacts를 활용하면 Azure DevOps에서 NuGet, npm 및 Maven 패키
 1. 
           **관리자: Windows PowerShell** 창에서 다음 명령을 실행하여 eShopOnWeb.Shared 폴더로 이동합니다.
 
-   ```text
+   ```powershell
    cd c:\eShopOnWeb\eShopOnWeb.Shared
    ```
 
    > **참고**: **eShopOnWeb.Shared** 폴더는 **eShopOnWeb.Shared.csproj** 파일의 위치입니다. 다른 위치 또는 프로젝트 이름을 선택한 경우 대신 해당 위치로 이동합니다.
 
-1. 다음을 실행하여 프로젝트에서 **.nupkg** 파일을 만듭니다.
+1. 다음을 실행하여 프로젝트에서 **.nupkg** 파일을 만듭니다(`XXXXXX` 자리 표시자 값을 고유한 문자열로 변경).
 
    ```powershell
-   dotnet pack .\eShopOnWeb.Shared.csproj
+   dotnet pack .\eShopOnWeb.Shared.csproj -p:PackageId=eShopOnWeb-XXXXX.Shared
    ```
 
    > **참고**: **dotnet pack** 명령은 프로젝트를 빌드하고 **bin\Release** 폴더에 NuGet 패키지를 만듭니다. **릴리스** 폴더가 없는 경우 **디버그** 폴더를 대신 사용할 수 있습니다.
 
    > **참고**: **관리자: Windows PowerShell** 창에 표시되는 경고는 무시하세요.
 
-   > **참고**: dotnet pack은 프로젝트에서 확인 가능한 정보를 토대로 최소 패키지를 빌드합니다. 예를 들어 이름은 **eShopOnWeb.Shared.1.0.0.nupkg**입니다. 이 버전 번호는 어셈블리에서 검색한 것입니다.
+   > **참고**: dotnet pack은 프로젝트에서 확인 가능한 정보를 토대로 최소 패키지를 빌드합니다. 인수 `-p:PackageId=eShopOnWeb-XXXXXX.Shared` 를 사용하면 프로젝트에 포함된 이름을 사용하는 대신 특정 이름으로 패키지를 만들 수 있습니다. 예를 들어 `12345` 문자열을 `XXXXXX` 자리 표시자로 대체하는 경우 패키지 이름은 **eShopOnWeb-12345.Shared.1.0.0.nupkg**가 됩니다. 버전 번호가 어셈블리에서 검색되었습니다.
 
 1. PowerShell 창에서 다음 명령을 실행하여 **bin\Release** 폴더를 엽니다.