Udostępnij za pośrednictwem


Szybki start: tworzenie pola deweloperskiego przy użyciu dostosowań zespołu

W tym przewodniku Szybki start utworzysz pole deweloperskie przy użyciu dostosowań zespołu usługi Microsoft Dev Box. Funkcja używa pliku definicji obrazu, dzięki czemu można tworzyć spójnie dostosowane pola deweloperskie dla zespołu deweloperów i zapewnić dostosowane środowisko dla projektów.

Ważne

Funkcja dostosowywania zespołu usługi Dev Box jest obecnie dostępna w wersji zapoznawczej. Aby uzyskać więcej informacji na temat stanu wersji zapoznawczej, zobacz Dodatkowe warunki użytkowania dla wersji zapoznawczych platformy Microsoft Azure. Dokument definiuje postanowienia prawne, które dotyczą funkcji platformy Azure, które są w wersji beta, w wersji zapoznawczej lub w inny sposób nie zostały jeszcze wydane do ogólnej dostępności.

Wymagania wstępne

Aby wykonać kroki opisane w tym przewodniku Szybki start, musisz mieć centrum deweloperskie skonfigurowane przy użyciu projektu usługi Dev Box.

Uprawnienia wymagane do konfigurowania dostosowań

Aby wykonać wymagane akcje tworzenia i stosowania dostosowań w polu deweloperskim, potrzebne są następujące uprawnienia:

Akcja Uprawnienie/rola
Włącz katalogi na poziomie projektu dla centrum deweloperów. Inżynier platformy z dostępem do zapisu w subskrypcji.
Włącz ustawienia synchronizacji katalogu dla projektu. Inżynier platformy z dostępem do zapisu w subskrypcji.
Dołączanie wykazu do projektu. Uprawnienia administratora lub współautora projektu.
Utwórz plik dostosowywania. Nie określono żadnego. Każdy może utworzyć plik dostosowywania.
Użyj portalu dla deweloperów, aby przekazać i zastosować plik YAML podczas tworzenia pola deweloperskiego. Użytkownik usługi Dev Box.
Dodawanie zadań do wykazu. Uprawnienie do dodawania do repozytorium hostujące wykaz.

Tworzenie definicji obrazu

  1. Pobierz przykładowy plik dostosowywania YAML.
  2. Otwórz plik i sprawdź zadania.

Plik definicji obrazu określa nazwę definicji obrazu przy użyciu name pola. Użyj tej nazwy, aby zidentyfikować definicję obrazu w puli usługi Dev Box.

Włączanie wykazów na poziomie projektu

Przed dodaniem wykazu do projektu należy włączyć wykazy na poziomie projektu na poziomie centrum deweloperów.

  1. W witrynie Azure Portal przejdź do centrum deweloperów.

  2. W menu usługi w obszarze Ustawienia wybierz pozycję Konfiguracja.

    Zrzut ekranu przedstawiający stronę Przegląd centrum deweloperskiego z wyróżnioną konfiguracją.

  3. W okienku Katalogi na poziomie projektu wybierz pozycję Włącz wykazy dla każdego projektu, a następnie wybierz pozycję Zastosuj.

    Zrzut ekranu przedstawiający okienko wykazów na poziomie projektu z wyróżnionym polem wyboru włączania katalogów dla projektu.

Dodawanie wykazu do projektu

W poniższych sekcjach opisano następujące zadania:

  1. Rozwidlenie przykładowego repozytorium wykazu w organizacji usługi GitHub.
  2. Zainstaluj i skonfiguruj aplikację Microsoft Centrum deweloperów.
  3. Przypisz uprawnienia w usłudze GitHub dla repozytoriów.
  4. Dodaj repozytorium jako wykaz.

Rozwidlenie przykładowego repozytorium wykazu

  1. Otwórz przykładowe repozytorium wykazu.
  2. Wybierz pozycję Rozwidlenie, aby rozwidlić repozytorium w organizacji usługi GitHub.

Instalowanie aplikacji Microsoft Centrum deweloperów

  1. Zaloguj się w witrynie Azure Portal.

  2. Przejdź do centrum deweloperskiego lub projektu.

  3. W menu usługi w obszarze Konfiguracja środowiska wybierz pozycję Wykazy, a następnie wybierz pozycję Dodaj.

  4. W okienku Dodawanie wykazu wprowadź lub wybierz następujące wartości:

    Pole Wartość
    Nazwa/nazwisko Wprowadź nazwę wykazu.
    Źródło wykazu Wybierz pozycję GitHub.
    Authentication type (Typ uwierzytelniania) Wybierz pozycję Aplikacja GitHub.
  5. Wybierz link Skonfiguruj repozytoria.

    Zrzut ekranu witryny Azure Portal przedstawiający opcje dodawania wykazu z wyróżnionym linkiem do konfigurowania repozytoriów.

  6. Jeśli zostanie wyświetlony monit o uwierzytelnienie w usłudze GitHub, uwierzytelnij się.

  7. Na stronie Microsoft DevCenter wybierz pozycję Konfiguruj.

    Zrzut ekranu przedstawiający stronę aplikacji Microsoft Centrum deweloperów z wyróżnionym przyciskiem Konfiguruj.

  8. Wybierz organizację usługi GitHub zawierającą repozytorium, które chcesz dodać jako wykaz. Aby zainstalować tę aplikację, musisz być właścicielem organizacji.

    Zrzut ekranu przedstawiający stronę Instalowanie programu Microsoft DevCenter z wyróżnioną organizacją usługi GitHub.

  9. Na stronie Instalowanie programu Microsoft DevCenter wybierz pozycję Tylko wybierz repozytoria, wybierz repozytorium, które chcesz dodać jako wykaz, a następnie wybierz pozycję Zainstaluj.

    Zrzut ekranu przedstawiający stronę Instalowanie programu Microsoft DevCenter z wybranym i wyróżnionym jednym repozytorium.

    Możesz wybrać wiele repozytoriów, które mają zostać dodane jako wykazy. Każde repozytorium należy dodać jako oddzielny wykaz, zgodnie z opisem w następnej sekcji tego przewodnika Szybki start.

  10. Na stronie Microsoft DevCenter by Microsoft chcesz uzyskać uprawnienia , przejrzyj wymagane uprawnienia, a następnie wybierz pozycję Autoryzuj microsoft DevCenter.

    Zrzut ekranu przedstawiający stronę żądającą uprawnień programu Microsoft DevCenter z wyróżnionym przyciskiem umożliwiającym autoryzowanie uprawnień.

Dodawanie repozytorium jako katalogu

  1. Wróć do witryny Azure Portal.

  2. W okienku Dodawanie wykazu wprowadź następujące informacje, a następnie wybierz pozycję Dodaj:

    Pole Wartość
    Repo Wybierz repozytorium, które chcesz dodać jako wykaz.
    Gałąź Wybierz gałąź.
    Ścieżka folderu Wybierz folder zawierający podfoldery zawierające definicje środowiska.

    Zrzut ekranu przedstawiający okienko witryny Azure Portal służące do dodawania wykazu z wyróżnionymi polami repozytorium, gałęzią i ścieżką folderu. Przycisk Dodaj jest również wyróżniony.

  3. W okienku Wykazy sprawdź, czy katalog jest wyświetlany. Po pomyślnym nawiązaniu połączenia w kolumnie Stan zostanie wyświetlona wartość Synchronizacja powiodła się.

    Zrzut ekranu przedstawiający okienko Katalogi witryny Azure Portal z połączonym stanem.

Tworzenie puli pól deweloperskich dla definicji obrazu

Aby utworzyć plik dostosowywania, plik imagedefintion.yaml, dostępny do tworzenia pól deweloperskich, należy określić go jako definicję obrazu dla puli.

Aby utworzyć pulę pól deweloperskich skojarzona z projektem:

  1. Zaloguj się w witrynie Azure Portal.

  2. W polu wyszukiwania wprowadź projekty. Na liście wyników wybierz pozycję Projekty.

  3. Otwórz projekt, w którym chcesz utworzyć pulę usługi Dev Box.

  4. Wybierz pozycję Pule pól deweloperskich, a następnie wybierz pozycję Utwórz.

  5. W okienku Tworzenie puli pól deweloperskich wprowadź następujące wartości:

    Ustawienie Wartość
    Nazwa/nazwisko Wprowadź nazwę puli. Nazwa puli jest widoczna dla deweloperów do wybrania podczas tworzenia pól deweloperskich. Nazwa musi być unikatowa w projekcie.
    Definicja Wybierz definicję o nazwie w pliku definicji obrazu.
    Połączenie sieciowe 1. Wybierz pozycję Wdróż w sieci hostowanej przez firmę Microsoft.
    2. Wybierz żądany region wdrożenia dla pól deweloperskich. Wybierz region blisko użytkowników usługi Dev Box, aby uzyskać optymalne środowisko użytkownika.
    Uprawnienia twórcy w polu deweloperskim Wybierz pozycję Administrator lokalny lub Użytkownik standardowy.
    Włączanie automatycznego zatrzymywania Wartość tak jest domyślna. Wybierz pozycję Nie , aby wyłączyć harmonogram automatycznego zatrzymywania. Harmonogram automatycznego zatrzymywania można skonfigurować po utworzeniu puli.
    Czas zatrzymania Wybierz godzinę zamknięcia wszystkich pól deweloperskich w puli. Wszystkie skrzynki deweloperskie w tej puli są zamykane o tej porze każdego dnia.
    Strefa czasowa Wybierz strefę czasową dla czasu zatrzymania.
    Licencjonowanie Zaznacz to pole wyboru, aby potwierdzić, że organizacja ma Korzyść użycia hybrydowego platformy Azure licencje, które mają zostać zastosowane do pól deweloperskich w tej puli.

    Zrzut ekranu przedstawiający okienko służące do wprowadzania podstawowych informacji na temat nowej puli pól deweloperskich, w tym pól dla nazwy i definicji. Definicja obrazu MyImageDefinition.yaml jest wyróżniona.

  6. Wybierz pozycję Utwórz.

  7. Sprawdź, czy nowa pula pól deweloperskich jest wyświetlana na liście. Może być konieczne odświeżenie ekranu.

Witryna Azure Portal wdraża pulę usługi Dev Box i uruchamia kontrole kondycji, aby upewnić się, że obraz i sieć przechodzą kryteria weryfikacji dla pól deweloperskich.

Tworzenie pola deweloperskiego z puli usługi Dev Box

Podczas tworzenia pola deweloperskiego z puli deweloperów definicja obrazu jest stosowana do pola deweloperskiego. Pole deweloperskie jest tworzone przy użyciu dostosowań określonych w pliku definicji obrazu.

Aby utworzyć pole deweloperskie w portalu deweloperów usługi Microsoft Dev Box:

  1. Zaloguj się do portalu deweloperów usługi Microsoft Dev Box.

  2. Wybierz pozycję Nowy>pole deweloperskie.

  3. W polu Dodaj dewelopera wprowadź następujące wartości:

    Ustawienie Wartość
    Nazwa/nazwisko Wprowadź nazwę pola deweloperskiego. Nazwy pól deweloperskich muszą być unikatowe w projekcie.
    Projekt Wybierz projekt z listy rozwijanej.
    Pula usługi Dev Box Wybierz pulę z listy rozwijanej, która zawiera wszystkie pule pól deweloperskich dla tego projektu. Wybierz pulę deweloperów w pobliżu, aby uzyskać najmniejsze opóźnienie.

    Po wybraniu opcji na stronie są wyświetlane następujące informacje:

    • Ile pól deweloperskich można utworzyć w wybranym projekcie, jeśli projekt ma skonfigurowane limity.
    • Niezależnie od tego, czy hibernacji jest obsługiwana, czy nie.
    • Czy dostosowania są włączone, czy nie.
    • Czas zamknięcia, jeśli pula, w której tworzysz pole deweloperskie, ma harmonogram zamknięcia.
    • Powiadomienie, że proces tworzenia pola deweloperskiego może potrwać 25 minut lub dłużej.
  4. Wybierz pozycję Utwórz , aby rozpocząć tworzenie pola deweloperskiego.

  5. Aby śledzić postęp tworzenia, użyj kafelka dev box w portalu deweloperów.

Sprawdź, czy dostosowanie zostało zastosowane

Usługa Dev Box stosuje dostosowania jako ostatni etap procesu tworzenia. Usługa Dev Box będzie e-mail dla Ciebie, gdy pole deweloperskie jest gotowe. Następnie możesz sprawdzić, czy dostosowania są stosowane.

  1. Poczekaj na potwierdzenie wiadomości e-mail o utworzeniu pola deweloperskiego.

  2. W portalu deweloperów na kafelku pola deweloperskiego wybierz pozycję Dostosowania akcji>.

    Zrzut ekranu przedstawiający kafelek pola deweloperskiego przedstawiający menu Akcje z wyróżnionym poleceniem Dostosowania.

  3. W okienku Szczegóły dostosowywania potwierdź dostosowania zastosowane do pola deweloperskiego.

    Zrzut ekranu przedstawiający okienko szczegółów dostosowywania z dostosowaniami zastosowanymi do pola deweloperskiego.

Czyszczenie zasobów

  1. Zaloguj się do portalu deweloperów.

  2. W polu deweloperskim, które chcesz usunąć, w menu Akcje wybierz pozycję Usuń.

    Zrzut ekranu przedstawiający menu Akcje pola deweloperskiego z poleceniem Usuń.

  3. Aby potwierdzić usunięcie, wybierz pozycję Usuń.

    Zrzut ekranu przedstawiający komunikat potwierdzający o usunięciu pola deweloperskiego.