다음을 통해 공유

빠른 시작: 팀 사용자 지정을 사용하여 개발 상자 만들기

이 빠른 시작에서는 Microsoft Dev Box 팀 사용자 지정을 사용하여 개발 상자를 만듭니다. 이 기능은 이미지 정의 파일을 사용하여 개발팀을 위해 일관되게 사용자 지정된 개발 상자를 만들고 프로젝트에 맞는 사용자 지정 환경을 제공할 수 있습니다.

필수 구성 요소

제품 요구 사항
Microsoft Dev Box - 개발 상자를 만들 수 있도록 개발 상자 풀 및 개발 상자 프로젝트를 사용하여 개발 센터를 설정합니다.
- 이미지 정의 파일에서 사용할 수 있는 작업을 사용하여 개발자 센터에 카탈로그를 연결합니다. 카탈로그가 없는 경우 GitHub 또는 Azure Repos에서 카탈로그 추가 및 구성을 참조하세요.- 권한개발 상자를 만들려면 하나 이상의 프로젝트에 Dev Box Users 보안 그룹에 가입해야 합니다.개발자 센터에 프로젝트 수준 카탈로그를 사용하려면, 구독에 대한 쓰기 권한이 있는 플랫폼 엔지니어가 필요합니다.프로젝트에서 카탈로그 동기화 설정을 사용하려면, 구독에 대한 쓰기 권한이 있는 플랫폼 엔지니어가 필요합니다.프로젝트에 카탈로그를 연결하려면, 프로젝트에서 개발자 센터 프로젝트 관리자 또는 기여자 권한이 있어야 합니다.사용자 지정 파일을 만들려면 특정 요구 사항이 없습니다. 누구나 사용자 지정 파일을 만들 수 있습니다.
- 개발자 포털을 사용하여 개발 상자를 만드는 동안 YAML 파일을 업로드하고 적용하려면 다음을 수행 합니다. Dev Box User.
- 카탈로그에 작업을 추가하려면 다음을 수행합니다. 카탈로그를 호스트하는 리포지토리에 추가할 수 있는 권한입니다.
비주얼 스튜디오 코드 - 최신 버전을 설치합니다.

이미지 정의 만들기

사용자 지정을 사용하여 개발 상자를 만들려면 이미지 정의 파일을 만들어야 합니다. 이미지 정의 파일은 개발 상자에 적용하려는 사용자 지정이 포함된 YAML 파일입니다. 이 빠른 시작의 예제 이미지 정의 파일을 시작점으로 사용할 수 있습니다.

프로젝트 수준 카탈로그 사용

프로젝트에 카탈로그를 추가하려면 먼저 개발자 센터 수준에서 프로젝트 수준 카탈로그를 사용하도록 설정해야 합니다.

  1. Azure Portal에서 개발자 센터로 이동합니다.

  2. 서비스 메뉴의 설정에서 개발자 센터 설정을 선택합니다.

  3. 프로젝트 수준 카탈로그에서 프로젝트당 카탈로그 사용을 선택한 다음 적용을 선택합니다.

    프로젝트당 카탈로그 사용이 선택되고 강조 표시된 개발자 센터 설정을 보여 주는 스크린샷

프로젝트에 카탈로그 추가

다음 섹션에서는 이러한 작업을 안내합니다.

  1. 카탈로그 리포지토리 예를 GitHub 조직에 포크합니다.
  2. 카탈로그를 프로젝트와 동기화하도록 동기화 설정을 구성합니다.
  3. 리포지토리를 카탈로그로 추가합니다.

카탈로그 리포지토리 예 포크

  1. 카탈로그 리포지토리 예를 엽니다.

  2. > 새포크 만들기를 선택하여 GitHub 조직에 리포지토리를 포크합니다.

    새 포크 만들기가 강조 표시된 GitHub의 eShop 리포지토리를 보여 주는 스크린샷

카탈로그 동기화 설정 구성

  1. Azure Portal로 다시 전환합니다.

  2. 검색 창에 프로젝트를 입력합니다. 결과 목록에서 프로젝트를 선택합니다.

  3. 카탈로그를 추가할 프로젝트를 선택합니다.

  4. 왼쪽 메뉴에서 설정>카탈로그를 선택합니다.

  5. 동기화 설정을 선택합니다.

    Azure Portal의 카탈로그 창 스크린샷. 동기화 설정 단추가 강조 표시되어 있습니다.

  6. 동기화 설정 창에서 다음을 수행합니다.

    • 이미지 정의가 지워지면 해당 정의를 선택하고 저장을 선택합니다.
    • 이미지 정의가 이미 선택된 경우 취소를 선택합니다.

    Azure Portal의 동기화 설정 창 스크린샷. 이미지 정의 확인란이 강조 표시되어 있습니다.

리포지토리를 카탈로그로 추가

  1. 카탈로그 페이지에서 추가를 선택합니다.

  2. 카탈로그 추가 창에서 다음 값을 입력하거나 선택합니다.

    필드 값
    이름 카탈로그 이름을 입력합니다.
    카탈로그 원본 GitHub를 선택합니다.
    인증 유형 GitHub 앱을 선택합니다.

  3. 리포지토리 구성 링크를 선택합니다.

    카탈로그를 추가하기 위한 선택 사항을 보여 주는 Azure Portal의 스크린샷. 리포지토리 구성 링크가 강조 표시되어 있습니다.

  4. GitHub에 인증하라는 메시지가 표시되면 인증합니다.

  5. Microsoft DevCenter 페이지에서 구성을 선택합니다.

    구성 단추가 강조 표시된 Microsoft 개발자 센터 앱 페이지의 스크린샷.

  6. 카탈로그로 추가하려는 리포지토리가 포함된 GitHub 조직을 선택합니다. 이 앱을 설치하려면 조직의 소유자여야 합니다.

    GitHub 조직이 강조 표시된 Microsoft DevCenter 설치 페이지의 스크린샷.

  7. Microsoft DevCenter 설치 페이지에서 리포지토리만 선택하고 카탈로그로 추가할 리포지토리를 선택한 다음 저장을 선택합니다.

    하나의 리포지토리가 선택되고 강조 표시된 Microsoft DevCenter 설치 페이지의 스크린샷.

    여러 리포지토리를 선택하여 카탈로그로 추가할 수 있습니다. 이 빠른 시작의 다음 섹션에 설명된 대로 각 리포지토리를 별도의 카탈로그로 추가해야 합니다.

  8. Azure Portal로 다시 전환합니다.

  9. 카탈로그 추가 창에서 GitHub로 로그인을 선택합니다.

  10. 카탈로그 추가 창에서 다음 정보를 입력한 다음 추가를 선택합니다.

    필드 값
    리포지토리 이미지 정의가 포함된 리포지토리를 선택합니다.
    예: eShop
    분기 브랜치를 선택하세요.
    예: main
    폴더 경로 이미지 정의를 포함하는 하위 폴더가 포함된 폴더를 선택합니다.
    예: .devcenter/catalog/image-definitions

  11. 카탈로그 창에서 카탈로그가 표시되는지 확인합니다. 연결이 성공하면 상태 열에 동기화 성공이 표시됩니다.

    동기화 성공 상태가 있는 카탈로그를 보여 주는 카탈로그 페이지의 스크린샷.

  12. 이미지 정의가 올바르게 동기화되었는지 확인합니다. 왼쪽 메뉴에서이미지 정의> 선택합니다. 이 예제에서는 다음 두 가지 이미지 정의를 볼 수 있습니다.

    • backend-dev - 이 이미지는 eShop 백 엔드 엔지니어링 환경에 적합한 Windows 11의 Microsoft Visual Studio + 도구 이미지입니다.
    • frontend-dev - 이 이미지는 eShop 프런트 엔드 엔지니어링 환경에 적합한 Windows 11의 Microsoft Visual Studio + 도구 이미지입니다.

    카탈로그에서 가져온 이미지 정의를 보여 주는 이미지 정의 페이지의 스크린샷

이미지 정의를 위한 개발 상자 풀 만들기

개발 상자를 만드는 데 사용할 수 있는 사용자 지정 파일인 imagedefintion.yaml을 만들려면 풀에 대한 이미지 정의로 지정합니다.

프로젝트와 연결된 개발 상자 풀을 만들려면 다음을 수행합니다.

  1. Azure Portal에서.

  2. 검색 창에 프로젝트를 입력합니다. 결과 목록에서 프로젝트를 선택합니다.

  3. 개발 상자 풀을 만들려는 프로젝트를 엽니다.

  4. 왼쪽 메뉴에서개발 상자 풀> 선택합니다.

  5. 개발 상자 풀 페이지에서 만들기를 선택합니다.

  6. 개발 상자 풀 만들기 창에서 다음 값을 입력합니다.

    설정 값
    이름 풀의 설명이 포함된 이름을 입력합니다. 풀 이름은 개발자가 개발 상자를 만들 때 선택할 수 있으므로 풀의 용도와 지역을 포함합니다. 이름은 프로젝트 내에서 고유해야 합니다.
    예: contoso-frontend-westUS
    정의 목록의 이미지 정의 섹션에서 이미지 정의를 선택합니다.
    예: contoso-catalog/frontend-dev
    컴퓨팅 풀에서 개발 상자에 대한 컴퓨팅 리소스를 선택합니다.
    예: vCPU 8개, 32GB RAM
    스토리지 풀에서 개발 상자에 대한 스토리지 옵션을 선택합니다.
    예: 256GB SSD
    최대 절전 모드 원본 이미지와 컴퓨팅 크기가 모두 최대 절전 모드와 호환되는 경우 최대 절전 모드가 지원됩니다.
    네트워크 연결 1. Microsoft 호스팅 네트워크에 배포를 선택합니다.
    2. 개발 상자에 대한 배포 지역을 선택합니다. 최적의 사용자 환경을 위해 개발 상자 사용자와 가까운 지역을 선택합니다.
    예: 미국 서부
    라이선스 조직에 이 풀의 개발 상자에 적용할 Azure 하이브리드 혜택 라이선스가 있는지 확인하려면 이 확인란을 선택합니다.

    새 개발 상자 풀을 만들기 위한 기본 사항 창의 스크린샷

  7. 만들기를 선택합니다.

  8. 새 개발 상자 풀이 목록에 나타나는지 확인합니다. 화면을 새로 고쳐야 할 수도 있습니다.

Azure Portal은 개발 상자 풀을 배포하고 상태 검사를 실행하여 이미지와 네트워크가 개발 상자에 대한 유효성 검사 조건을 통과하는지 유효성을 검사합니다.

개발 상자 풀에서 개발 상자 만들기

개발 상자 풀에서 개발 상자를 만들면 이미지 정의가 개발 상자에 적용됩니다. 개발 상자는 이미지 정의 파일에 지정된 사용자 지정을 사용하여 만들어집니다.

Microsoft Dev Box 개발자 포털에서 개발 상자를 만들려면:

  1. Microsoft Dev Box 개발자 포털에 로그인합니다.

  2. 새로 만들기>새 개발 상자를 선택합니다.

  3. 개발 상자 추가에서 다음 값을 입력합니다.

    설정 값
    이름 개발 상자의 이름을 입력합니다. 개발 상자 이름은 프로젝트 내에서 고유해야 합니다.
    예: contoso-frontend-dev-box
    프로젝트 개발자 포털에는 액세스할 수 있는 프로젝트가 나열됩니다. 목록에서 필요한 프로젝트를 선택합니다.
    개발 상자 풀 개발자 포털에는 선택한 프로젝트에 대한 모든 개발 상자 풀이 나열됩니다. 작업에 적합한 풀을 선택합니다. 가장 낮은 대기 시간을 위해 가까운 개발 상자 풀을 선택합니다.
    사용자 지정 적용 이 확인란을 선택 취소된 상태로 둡니다. 사용자 사용자 지정을 적용하는 데 사용됩니다. 이 문서에서는 팀 사용자 지정을 구성했습니다.

    선택을 마치면 페이지에 다음 정보가 표시됩니다.

    • 최대 절전 모드 지원 여부.
    • 개발 상자 만들기 프로세스가 25분 이상 걸릴 수 있다는 알림.

  4. 만들기를 선택하여 개발 상자 만들기를 시작합니다.

  5. 만들기 진행률을 추적하려면 개발자 포털의 개발 상자 타일을 사용합니다.

사용자 지정이 적용되었는지 확인

Dev Box는 제작 프로세스의 마지막 단계에서 사용자 지정을 적용합니다. 개발 상자가 준비되면 Dev Box에서 이메일을 보냅니다. 그런 다음 사용자 지정이 적용되었는지 확인할 수 있습니다.

  1. 개발 상자가 만들어질 때까지 기다립니다.

  2. 개발자 포털의 개발 상자 타일에서 작업>사용자 지정을 선택합니다.

    사용자 지정 명령이 강조 표시된 작업 메뉴를 보여 주는 개발 상자 타일의 스크린샷.

  3. 사용자 지정 세부 정보 창에서 개발 상자에 적용된 사용자 지정을 확인합니다.

    개발 상자에 적용된 사용자 지정을 보여 주는 사용자 지정 세부 정보 창의 스크린샷.

리소스 정리

  1. 개발자 포털에 로그인합니다.

  2. 삭제하려는 개발 상자의 경우 작업 메뉴에서 삭제를 선택합니다.

    삭제 명령이 있는 개발 상자 작업 메뉴의 스크린샷.

  3. 삭제를 확인하려면 삭제를 선택합니다.

    개발 상자 삭제에 대한 확인 메시지의 스크린샷.

관련 콘텐츠

  • Last updated on