Samouczek: tworzenie i wdrażanie pakietu w obszarze roboczym

Aby ułatwić rozpoczęcie korzystania z pakietów deklaratywnej automatyzacji w obszarze roboczym, ten samouczek przeprowadzi Cię przez proces tworzenia pakietu z zadaniem, wdrażania go i uruchamiania zadania w pakiecie — wszystko z obszaru roboczego.

Aby uzyskać wymagania dotyczące używania pakietów w obszarze roboczym, zobacz Deklaratywne pakiety automatyzacji w wymaganiach dotyczących obszaru roboczego.

Aby uzyskać więcej informacji na temat pakietów, zobacz Co to są pakiety deklaratywne automatyzacji?.

Tworzenie pakietu

Najpierw utwórz pakiet w obszarze roboczym usługi Databricks:

  1. Przejdź do folderu Git, w którym chcesz utworzyć pakiet.

    Wskazówka

    Jeśli wcześniej otwarto folder Git w edytorze w obszarze roboczym, możesz użyć menu kontekstów tworzenia przeglądarki obszaru roboczego, aby szybko przejść do folderu Git. Zobacz Tworzenie kontekstów.

  2. Kliknij przycisk Utwórz, a następnie wybierz Pakiet. Alternatywnie kliknij prawym przyciskiem myszy folder Git lub skojarzony z nim kebab w drzewie obszaru roboczego, a następnie kliknij pozycję Utwórz>pakiet:

    Tworzenie pakietu

  3. W oknie dialogowym Tworzenie pakietu nadaj pakietowi nazwę, taką jak total-awesome-bundle. Nazwa pakietu może zawierać tylko litery, cyfry, kreski i podkreślenia. Wybierz pozycję Pusty projekt , a następnie kliknij przycisk Dalej .

    Okno dialogowe tworzenia nowego pakietu

Spowoduje to utworzenie początkowego pakietu w folderze Git, który zawiera .gitignore plik konfiguracji Git i wymagane deklaratywne pakiety automatyzacji databricks.yml. Plik databricks.yml zawiera główną konfigurację pakietu. Aby uzyskać szczegółowe informacje, zobacz Deklaratywne konfiguracje pakietów automatyzacji.

Nowy pakiet

Dodawanie notesu

Następnie dodaj notes do pakietu. Notatnik w poniższym przykładzie wyświetla tekst "Hello world!".

  1. Kliknij kafelek Dodaj pakiet projektu notatnika. Alternatywnie kliknij ikonę menu dla pakietu w spisie treści, a następnie kliknij pozycję Utwórz>Notatnik.

  2. Zmień nazwę notesu na helloworld.

  3. Ustaw język notesu na Python i wklej następujący kod w komórce notesu:

    print("Hello World!")

Definiowanie zadania

Teraz zdefiniuj zadanie uruchamiające notes.

  1. Kliknij ikonę wdrożenia pakietu, aby przełączyć się na panel Wdrożenia .

    Ikona panelu Wdrożenia

  2. W sekcji Zasoby pakietu kliknij pozycję Dodaj, a następnie pozycję Nowa definicja zadania.

    Tworzenie definicji zadania

  3. Wpisz run-notebook w polu Nazwa zadania okna dialogowego Dodawanie zadania do istniejącego pakietu . Kliknij pozycję Dodaj i wdróż.

  4. Zostanie wyświetlone okno dialogowe Potwierdzenia wdrażania w środowisku deweloperskim z informacjami o zasobie zadania, który zostanie utworzony w docelowym obszarze roboczym dewelopera. Kliknij Wdróż.

  5. Wróć do plików pakietu, klikając ikonę folderu nad ikoną wdrożeń. Zasób run-notebook.job.yml zadania został utworzony przy użyciu podstawowego kodu YAML dla zadania i dodatkowego komentarza przykładowego zadania YAML.

  6. Dodaj zadanie notesu do definicji zadania. Zastąp przykładowy kod YAML w run-notebook.job.yml pliku następującym kodem:

    resources:
  jobs:
    run_notebook:
      name: run-notebook
      queue:
        enabled: true
      tasks:
        - task_key: my-notebook-task
          notebook_task:
            notebook_path: ../helloworld.ipynb

    Konfiguracja zadania notebooka YAML

Aby uzyskać szczegółowe informacje na temat definiowania zadania w języku YAML, zobacz job (Zadanie). Aby uzyskać składnię YAML dla innych obsługiwanych typów zadań, zobacz Dodawanie zadań do zadań w pakietach deklaratywnej automatyzacji.

Wdrażanie pakietu

Następnie wdróż pakiet i uruchom zadanie zawierające zadanie notesu helloworld .

  1. W okienku Wdrożenia dla pakietu w obszarze Cele kliknij listę rozwijaną, aby wybrać dev docelowy obszar roboczy, jeśli nie został jeszcze wybrany. Docelowe obszary robocze są definiowane w targets mapowaniu pakietu databricks.yml. Zobacz Deklaratywne tryby wdrażania pakietów automatyzacji.

    Wybieranie wdrożenia docelowego

  2. Kliknij przycisk Wdróż . Pakiet jest weryfikowany, a szczegóły weryfikacji są wyświetlane w oknie dialogowym.

  3. Przejrzyj szczegóły wdrożenia w tym oknie dialogowym Potwierdzanie wdrażania w środowisku deweloperskim , a następnie kliknij przycisk Wdróż.

    Okno dialogowe wdrażania na środowisko deweloperskie

    Ważne

    Kod jest wykonywany jako bieżący użytkownik podczas wdrażania pakietów i uruchamiania zasobów pakietu. Upewnij się, że ufasz kodowi w pakiecie, w tym YAML, który może zawierać ustawienia konfiguracji uruchamiające polecenia.

Status wdrożenia jest wyświetlany w oknie Danych wyjściowych projektu.

Uruchamianie zadania

Wdrożone zasoby pakietu znajdują się na liście w obszarze Zasoby pakietu. Kliknij ikonę odtwarzania skojarzoną z zasobem zadania, aby go uruchomić.

Wyświetlanie listy wdrożonych zasobów

Przejdź do pozycji Zadanie uruchamiane z lewego paska nawigacyjnego, aby zobaczyć uruchomienie pakietu. Nazwa uruchomienia zadania pakietu jest poprzedzona prefiksem, np. [dev someone] run-notebook.

Dalsze kroki

  • Last updated on