Udostępnij za pośrednictwem

Poznaj przepływy inicjalizacji narzędzia Azure Developer CLI

Interfejs wiersza polecenia dla deweloperów platformy Azure (azd) udostępnia zestaw poleceń usprawniających opracowywanie, aprowizowanie i wdrażanie aplikacji na platformie Azure. Polecenie azd init ułatwia skonfigurowanie nowych lub istniejących projektów przez wygenerowanie plików i konfiguracji wymaganych do pracy z azdprogramem . W tym artykule opisano różne dostępne przepływy pracy inicjowania i sposób wybierania najlepszej opcji dla scenariusza programowania.

Przepływy pracy inicjowania

Polecenie azd init obsługuje kilka przepływów pracy, aby przygotować aplikację do pracy z usługą azd:

  • Skanuj bieżący katalog: analizuje istniejącą bazę kodu aplikacji w celu wygenerowania odpowiednich azd plików konfiguracji i zasobów.
  • Wybierz szablon: Klonuje i inicjuje azd szablon z galerii szablonów.
  • Tworzenie minimalnego projektu: inicjuje podstawowy azure.yaml plik jako punkt wyjścia do tworzenia własnego azd szablonu od podstaw.

Wybierz podejście, które najlepiej pasuje do projektu. Wszystkie te przepływy zostały szczegółowo opisane w artykule Tworzenie szablonów — omówienie i powiązane artykuły. W poniższych sekcjach przedstawiono koncepcyjne omówienie każdego przepływu.

Skanuj bieżący katalog

Użyj tego przepływu pracy, gdy masz istniejącą bazę kodu aplikacji i chcesz przygotować ją do wdrożenia na platformie Azure przy użyciu polecenia azd.

  1. Przejdź do katalogu głównego projektu.

  2. azd init Uruchom polecenie:

    azd init

  3. Wybierz pozycję Skanuj bieżący katalog. azd będzie:

    • Przeskanuj katalog, aby określić język lub strukturę używaną przez aplikację.
    • Wybierz odpowiednią platformę hostingu, taką jak Azure Container Apps.
    • W razie potrzeby poproś o dodanie lub usunięcie wykrytych usług.
    ? How do you want to initialize your app? Scan current directory

  (✓) Done: Scanning app code in current directory

Detected services:

  .NET
  Detected in: src

azd will generate the files necessary to host your app on Azure using Azure Container Apps.

? Select an option  [Use arrows to move, type to filter]
> Confirm and continue initializing my app
  Remove a detected service
  Add an undetected service

  4. Wybierz pozycję Potwierdź i kontynuuj inicjowanie aplikacji , aby ukończyć przepływ pracy. azd tworzy następujące elementy w katalogu aplikacji:

    • Plik azure.yaml, który definiuje usługi aplikacji i przyporządkowuje je do zasobów hostingu.
    • .azure folder służący do przechowywania ustawień konfiguracji, takich jak nazwa środowiska.
    • .gitignore Plik skonfigurowany dla języka aplikacji i platformy hostingu.

  5. Opcjonalnie uruchom polecenie azd up , aby utworzyć zasoby usługi Azure Container Apps i wdrożyć aplikację.

Twoja aplikacja jest teraz ustrukturyzowana jako azd szablon, który można nadal opracowywać i rozszerzać przy użyciu większej liczby zasobów i usług platformy Azure.

Wybieranie szablonu

Ten przepływ pracy umożliwia rozpoczęcie od wstępnie utworzonego azd szablonu, który zwykle zawiera zarówno kod aplikacji, jak i niezbędne definicje infrastruktury platformy Azure.

  1. azd init Uruchom polecenie:

    azd init

    Uwaga / Notatka

    Możesz również uruchomić azd init z parametrem --template aby bezpośrednio zainicjować szablon przez nazwę i pominąć wybór procesu pracy.

  2. Wybierz Wybierz szablon. azd Wyświetla listę dostępnych szablonów ze skonfigurowanych źródeł szablonów.

    ? How do you want to initialize your app? Select a template
? Select a project template:  [Use arrows to move, type to filter]
> Deploy Phoenix to Azure
  (Arize-ai/phoenix-on-azure)

  API Center Reference Sample
  (Azure-Samples/APICenter-Reference)

  Event Driven Java Application with Azure Service Bus on Azure Spring Apps
  (Azure-Samples/ASA-Samples-Event-Driven-Application)

  Static React Web App with Java API and PostgreSQL
  (Azure-Samples/ASA-Samples-Web-Application)

  3. Wpisz, aby przefiltrować wyniki i znaleźć szablon Hello AZD. Naciśnij Enter, aby sklonować i zainicjować szablon.

  4. Opcjonalnie uruchom polecenie azd up , aby aprowizować i wdrożyć zasoby szablonu na platformie Azure.

Możesz również użyć zainicjowanego szablonu jako punktu wyjścia do dalszego programowania.

Tworzenie minimalnego projektu

W przypadku zaawansowanych użytkowników, którzy chcą rozpocząć od minimalnej konfiguracji i dostosować wszystko ręcznie, ta opcja zapewnia tylko podstawową konfigurację.

  1. azd init Uruchom polecenie z flagą --minimal :

    azd init --minimal

  2. Po wyświetleniu monitu wprowadź nazwę azd szablonu i naciśnij Enter.

    ? How do you want to initialize your app? Create a minimal project
? What is the name of your project? (empty) hello-azd
? What is the name of your project? hello-azd

SUCCESS: Generated azure.yaml project file.
Run azd add to add new Azure components to your project.

    Flaga --minimal tworzy tylko następujące elementy:

    • Podstawowy plik azure.yaml zawierający tylko nazwę projektu i "schemaVersion"
    • .azure Katalog konfiguracji środowiska
    • Plik .gitignore z odpowiednimi wpisami dla Azure Developer CLI

    Ta usprawniona inicjalizacja jest idealna, gdy:

    • Chcesz utworzyć infrastrukturę od podstaw
    • Konieczność integracji azd z istniejącym złożonym projektem
    • Zaplanuj użycie polecenia azd add w celu stopniowego budowania architektury
    • Preferuj pełną kontrolę nad strukturą projektu

  3. Po zainicjowaniu można wykonać następujące czynności:

    • Ręcznie utwórz pliki infrastruktury w folderze infra
    • azd add Użyj funkcji redagowania, aby rozpocząć dodawanie zasobów platformy Azure do aplikacji
    • Dostosuj twój plik azure.yaml w celu zdefiniowania usług i zasobów

Nazewnictwo zasobów projektu i platformy Azure

Podczas inicjowania nowego lub istniejącego projektu nazwa projektu jest ustawiona na .azure.yaml Nazwa projektu działa jako prefiks nazw zasobów platformy Azure utworzonych podczas procesu aprowizacji. Przestrzegając reguł walidacji, upewnij się, że wygenerowane nazwy zasobów platformy Azure będą również prawidłowe.

W szablonach Bicep lub Terraform nazwa projektu jest często używana jako podstawa do konstruowania nazw zasobów w połączeniu z nazwą środowiska i innymi elementami. Przykład:

var resourceToken = '${name}-${environmentName}'

Gdzie name odwołuje się do nazwy projektu i environmentName jest nazwą azd środowiska.

Reguły sprawdzania poprawności nazw projektów

Podczas inicjowania azd init projektu lub podczas tworzenia nowej nazwy projektu w azure.yaml pliku są stosowane następujące reguły sprawdzania poprawności:

Reguła Description
Dozwolone znaki Nazwy projektów mogą zawierać tylko małe litery, cyfry i łączniki.
Znak początkowy Nazwy projektów muszą zaczynać się literą.
Znak końcowy Nazwy projektów nie mogą kończyć się łącznikiem.
Długość Nazwy projektów muszą mieć długość od 2 do 63 znaków.
Brak kolejnych łączników Nazwy projektów nie mogą zawierać kolejnych łączników.

Te reguły walidacji zapewniają, że nazwa projektu będzie zgodna z wymaganiami dotyczącymi nazewnictwa zasobów platformy Azure i zapobiegnie niepowodzeniu tworzenia pakietów usług podczas wdrażania.

Dalsze kroki

Po zainicjowaniu projektu za pomocą azd initpolecenia można wykonać następujące czynności:

  • Zmodyfikuj wygenerowane pliki infrastruktury, aby dostosować zasoby platformy Azure.
  • Użyj azd provision polecenia , aby utworzyć wymagane zasoby na platformie Azure.
  • Użyj polecenia azd deploy , aby wdrożyć kod aplikacji w aprowizowanych zasobach.
  • Dowiedz się więcej o przepływie pracy Azure Developer CLI w celu połączenia przydziału zasobów i wdrażania w jednym poleceniu.

Treści powiązane

  • Last updated on