다음을 통해 공유


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

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

Important

Dev Box 팀 사용자 지정 기능은 현재 미리 보기로 제공됩니다. 미리 보기 상태에 대한 자세한 내용은 Microsoft Azure 미리 보기에 대한 추가 사용 약관을 참조하세요. 이 문서에서는 베타, 미리 보기 또는 아직 일반 공급으로 릴리스되지 않은 Azure 기능에 적용되는 법적 조건을 정의합니다.

필수 조건

이 빠른 시작의 단계를 완료하려면 개발 상자 프로젝트로 구성된 개발자 센터가 있어야 합니다.

사용자 지정을 구성하는 데 필요한 권한

개발 상자에 사용자 지정을 만들고 적용하는 데 필요한 작업을 수행하려면 다음 권한이 필요합니다.

작업 권한/역할
개발자 센터에 프로젝트 수준 카탈로그를 사용하도록 설정합니다. 구독에 대한 쓰기 액세스 권한이 있는 플랫폼 엔지니어입니다.
프로젝트에 카탈로그 동기화 설정을 사용하도록 설정합니다. 구독에 대한 쓰기 액세스 권한이 있는 플랫폼 엔지니어입니다.
프로젝트에 카탈로그를 연결합니다. 프로젝트에 대한 프로젝트 관리자 또는 기여자 권한입니다.
사용자 지정 파일을 만듭니다. 지정한 항목이 없습니다. 누구나 사용자 지정 파일을 만들 수 있습니다.
개발자 포털을 사용하여 개발 상자를 만드는 동안 YAML 파일을 업로드하고 적용합니다. Dev Box User.
카탈로그에 작업을 추가합니다. 카탈로그를 호스트하는 리포지토리에 추가할 수 있는 권한입니다.

이미지 정의 만들기

  1. YAML 사용자 지정 파일 예제를 다운로드합니다.
  2. 파일을 열고 작업을 검사합니다.

이미지 정의 파일은 필드를 사용하여 name 이미지 정의의 이름을 지정합니다. 이 이름을 사용하여 개발 상자 풀에서 이미지 정의를 식별합니다.

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

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

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

  2. 서비스 메뉴의 설정에서 구성을 선택합니다.

    구성이 강조 표시된 개발자 센터의 개요 페이지를 보여 주는 스크린샷

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

    프로젝트당 카탈로그를 사용하도록 설정하기 위한 확인란이 강조 표시된 프로젝트 수준 카탈로그의 창을 보여 주는 스크린샷

프로젝트에 카탈로그 추가

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

  1. 예제 카탈로그 리포지토리를 GitHub 조직에 포크합니다.
  2. Microsoft 개발자 센터 앱을 설치하고 구성합니다.
  3. 리포지토리에 대해 GitHub에서 권한을 할당합니다.
  4. 리포지토리를 카탈로그로 추가합니다.

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

  1. 예제 카탈로그 리포지토리를 엽니다.
  2. 포크를 선택하여 리포지토리를 GitHub 조직에 포크합니다.

Microsoft 개발자 센터 앱 설치

  1. Azure Portal에 로그인합니다.

  2. 개발자 센터 또는 프로젝트로 이동합니다.

  3. 서비스 메뉴의 환경 구성에서 카탈로그를 선택한 다음 추가를 선택합니다.

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

    필드
    이름 카탈로그 이름을 입력합니다.
    카탈로그 원본 GitHub를 선택합니다.
    인증 유형 GitHub 앱을 선택합니다.
  5. 리포지토리 구성 링크를 선택합니다.

    리포지토리 구성 링크가 강조 표시된 카탈로그를 추가하기 위한 선택 항목을 보여 주는 Azure Portal의 스크린샷

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

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

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

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

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

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

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

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

  10. Microsoft DevCenter by Microsoft에서 페이지에 대한 사용 권한을 원하는 경우 필요한 권한을 검토한 다음, Microsoft DevCenter 권한 부여를 선택합니다.

    권한 부여 단추가 강조 표시된 Microsoft DevCenter 권한을 요청하는 페이지의 스크린샷.

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

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

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

    필드
    리포지토리 카탈로그로 추가하려는 리포지토리를 선택합니다.
    Branch 분기를 선택합니다.
    폴더 경로 환경 정의를 보관하는 하위 폴더가 포함된 폴더를 선택합니다.

    리포지토리, 분기 및 폴더 경로 상자가 강조 표시된 카탈로그를 추가하기 위한 Azure Portal 창의 스크린샷 추가 단추도 강조 표시됩니다.

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

    연결된 상태가 있는 Azure Portal 카탈로그 창의 스크린샷.

이미지 정의에 대한 개발 상자 풀 만들기

사용자 지정 파일인 imagedefintion.yaml을 개발 상자 만들기에 액세스할 수 있도록 하려면 풀에 대한 이미지 정의로 지정합니다.

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

  1. Azure Portal에 로그인합니다.

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

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

  4. 개발 상자 풀를 선택한 다음, 만들기를 선택합니다.

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

    설정
    이름 풀 이름을 입력합니다. 풀 이름은 개발자가 개발 상자를 만들 때 선택할 수 있도록 표시됩니다. 이름은 프로젝트 내에서 고유해야 합니다.
    정의 이미지 정의 파일에 명명된 대로 정의를 선택합니다.
    네트워크 연결 1. Microsoft 호스팅 네트워크에 배포를 선택합니다.
    2. 개발 상자에 원하는 배포 지역을 선택합니다. 최적의 사용자 환경을 위해 개발 상자 사용자와 가까운 지역을 선택합니다.
    개발 상자 작성자 권한 로컬 관리자 또는 표준 사용자를 선택합니다.
    자동 중지 사용 가 기본값입니다. 자동 중지 일정을 사용하지 않으려면 아니요를 선택합니다. 풀이 만들어진 후에는 자동 중지 일정을 구성할 수 있습니다.
    중지 시간 풀의 모든 개발 상자를 종료할 시간을 선택합니다. 이 풀의 모든 개발 상자는 매일 이 시간에 종료됩니다.
    표준 시간대 중지 시간에 대한 표준 시간대를 선택합니다.
    라이선싱 조직에 이 풀의 개발 상자에 적용할 Azure 하이브리드 혜택 라이선스가 있는지 확인하려면 이 확인란을 선택합니다.

    이름 및 정의 필드를 포함하여 새 개발 상자 풀에 대한 기본 정보를 입력하는 창의 스크린샷. 이미지 정의 MyImageDefinition.yaml이 강조 표시됩니다.

  6. 만들기를 실행합니다.

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

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

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

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

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

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

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

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

    설정
    이름 개발 상자의 이름을 입력합니다. 개발 상자 이름은 프로젝트 내에서 고유해야 합니다.
    프로젝트 드롭다운 목록에서 프로젝트를 선택합니다.
    개발 상자 풀 해당 프로젝트에 대한 모든 개발 상자 풀을 포함하는 드롭다운 목록에서 풀을 선택합니다. 가장 짧은 대기 시간에 가까운 개발 상자 풀을 선택합니다.

    선택한 후 페이지에 다음 정보가 표시됩니다.

    • 프로젝트에 제한이 구성되어 있는 경우 선택한 프로젝트에서 만들 수 있는 개발 상자 수.
    • 최대 절전 모드가 지원되는지 여부입니다.
    • 사용자 지정을 사용할지 여부입니다.
    • 개발 상자를 만드는 풀에 종료 일정이 있는 경우 종료 시간.
    • 개발 상자 만들기 프로세스가 25분 이상 걸릴 수 있다는 알림.
  4. 만들기를 선택하여 개발 상자 만들기를 시작합니다.

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

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

Dev Box는 만들기 프로세스의 최종 단계로 사용자 지정을 적용합니다. 개발 상자가 준비되면 Dev Box에서 전자 메일을 보냅니다. 그런 다음 사용자 지정이 적용되어 있는지 확인할 수 있습니다.

  1. 개발 상자가 생성되었다는 전자 메일 확인을 기다립니다.

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

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

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

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

리소스 정리

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

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

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

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

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