View a markdown version of this page

Membangun dan menguji paket secara lokal - Awan Batas Waktu
PrasyaratMembangun dan menerbitkan paket ke saluran lokalMembangun DebuggingMenguji paketMenghapus paket dari saluranMembersihkan

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Membangun dan menguji paket secara lokal

Sebelum menerbitkan paket ke Amazon S3 atau menyiapkan CI/CD otomatisasi di farm Deadline Cloud Anda, Anda dapat membuat dan menguji paket conda di workstation menggunakan saluran sistem file lokal. Pendekatan ini memungkinkan Anda dengan cepat mengulangi resep secara lokal dan memverifikasi paket.

Per rattler-build publish intah membuat resep, menyalin paket yang dihasilkan ke saluran, dan mengindeks saluran dalam satu langkah. Ketika Anda menargetkan direktori filesystem lokal, rattler-build membuat dan menginisialisasi saluran secara otomatis jika direktori tidak ada.

Petunjuk berikut menggunakan resep sampel Blender 4.5 dari repositori sampel Deadline Cloud di GitHub situs web. Anda dapat mengganti resep yang berbeda dari repositori sampel atau menggunakan resep Anda sendiri.

Prasyarat

Sebelum Anda mulai, instal alat berikut di workstation Anda:

  • pixi — Manajer paket yang Anda gunakan untuk menginstal rattler-build dan menguji paket. Untuk petunjuk instalasi, lihat pixi.sh di situs web Pixi.

  • rattler-build — Alat pembuatan paket yang digunakan oleh resep conda Deadline Cloud. Setelah Anda menginstal pixi, jalankan perintah berikut untuk menginstalrattler-build.

    pixi global install rattler-build

  • git — Diperlukan untuk mengkloning repositori sampel. PadaWindows, Git for Windows di situs web Git untuk Windows juga menyediakan bash shell, yang diperlukan beberapa resep Windows sampel.

Membangun dan menerbitkan paket ke saluran lokal

Dalam prosedur ini, Anda mengkloning repositori sampel Deadline Cloud dan menggunakannya rattler-build publish untuk membangun dan menerbitkan paket ke saluran sistem file lokal.

catatan

Aplikasi besar dapat membutuhkan puluhan GB ruang disk kosong untuk arsip sumber, file yang diekstraksi, dan output build. Pastikan Anda menggunakan disk dengan ruang yang cukup tersedia untuk output build paket.

Untuk membangun dan menerbitkan paket ke saluran lokal

  1. Kloning repositori sampel Deadline Cloud.

    git clone https://github.com/aws-deadline/deadline-cloud-samples.git

  2. Ubah ke direktori conda_recipes.

    cd deadline-cloud-samples/conda_recipes

  3. Jalankan perintah berikut untuk membangun resep Blender 4.5 dan menerbitkan paket ke direktori saluran lokal.

    Akti Linux f macOS kan dan, jalankan perintah berikut.

    rattler-build publish blender-4.5/recipe/recipe.yaml \
    --to file://$HOME/my-conda-channel \
    --build-number=+1

    Pada Windows (cmd), jalankan perintah berikut.

    rattler-build publish blender-4.5/recipe/recipe.yaml ^
    --to file://%USERPROFILE%/my-conda-channel ^
    --build-number=+1

    Per rattler-build publish intah melakukan tindakan berikut:

    • Membangun paket dari resep.

    • Membuat direktori saluran jika direktori tidak ada.

    • Menyalin file paket ke saluran.

    • Mengindeks saluran sehingga manajer paket dapat menemukan paket.

    Jika resep paket Anda bergantung pada paket dari saluran tertentu, seperti conda-forge di situs web conda-forge, tambahkan -c conda-forge ke perintah.

Tentang nomor build

--build-number=+1Opsi ini secara otomatis memilih nomor build berikutnya berdasarkan apa yang sudah ada di saluran tujuan. Praktik terbaik adalah jangan pernah mengganti paket di saluran. Selalu buat ke nomor build baru jika paket memiliki nama file yang sama. Menggunakan --build-number=+1 mencapai hal ini saat Anda membangun ke saluran produksi atau saluran pementasan yang mencerminkan produksi.

Jika Anda ingin mengontrol nomor build secara langsung, Anda dapat mengaturnya dengan nilai tertentu seperti--build-number=7. Jika Anda menghilangkan opsi, gunakan rattler-build nomor build yang ditentukan dalam recipe.yaml file.

Untuk informasi selengkapnyarattler-build publish, lihat dokumentasi penerbitan rattler-build di situs web prefix.dev.

Membangun Debugging

Jika build gagal, per rattler-build tahankan direktori build sehingga Anda dapat menyelidiki. Jalankan perintah berikut untuk membuka shell interaktif di lingkungan build dengan semua variabel lingkungan yang diatur seperti selama pembuatan.

rattler-build debug shell

Dari shell debug, Anda dapat memodifikasi file, menjalankan perintah build individual, dan menambahkan dependensi untuk mengisolasi masalah. Untuk informasi selengkapnya, lihat Debugging build di situs web prefix.dev.

Menguji paket

Setelah Anda membangun dan menerbitkan paket, buat proyek pixi sementara. Gunakan proyek untuk menginstal paket dari saluran lokal dan verifikasi bahwa itu berfungsi dengan benar.

Untuk menguji paket

  1. Buat direktori pengujian sementara dan inisialisasi proyek pixi dengan saluran lokal.

    Akti Linux f macOS kan dan, jalankan perintah berikut.

    mkdir package-test-env
cd package-test-env
pixi init --channel file://$HOME/my-conda-channel

    Pada Windows (cmd), jalankan perintah berikut.

    mkdir package-test-env
cd package-test-env
pixi init --channel file://%USERPROFILE%/my-conda-channel

  2. Tambahkan paket ke proyek.

    pixi add blender=4.5

  3. Pastikan paket berfungsi dengan benar.

    pixi run blender --version

    Per pixi run intah mengaktifkan lingkungan conda untuk direktori proyek dan menjalankan perintah yang ditentukan di dalamnya. Lingkungan tetap ada di direktori proyek, sehingga Anda dapat menggunakan pixi run perintah yang sama dari terminal lain. Untuk informasi lebih lanjut, lihat pixi run perintah di situs web Pixi.

Ketika Anda puas dengan paket tersebut, Anda dapat menerbitkan paket ke saluran conda Amazon S3 sehingga pekerja Deadline Cloud dapat menginstal paket. Lihat Mempublikasikan paket ke saluran conda S3.

Menghapus paket dari saluran

Hindari menghapus paket dari saluran yang Anda gunakan untuk produksi, karena lockfiles mereferensikan paket tertentu dengan hash. Menghapus paket mencegah pembuatan ulang lingkungan dari file kunci tersebut. Untuk pengembangan dan pengujian saluran, Anda dapat menghapus paket tertentu dengan menghapus .conda file dari direktori saluran dan kemudian mengindeks ulang saluran. Pertama, instalrattler-index.

pixi global install rattler-index

Kemudian hapus file paket dan indeks ulang saluran.

Akti Linux f macOS kan dan, jalankan perintah berikut.

rm $HOME/my-conda-channel/linux-64/blender-4.5.0-hb0f4dca_1.conda
rattler-index fs $HOME/my-conda-channel

Pada Windows (cmd), jalankan perintah berikut.

del %USERPROFILE%\my-conda-channel\win-64\blender-4.5.0-hb0f4dca_1.conda
rattler-index fs %USERPROFILE%\my-conda-channel

File paket disimpan dalam subdirektori khusus platform sepertilinux-64,, win-64 atau. osx-arm64 Buat daftar isi subdirektori ini untuk menemukan nama file yang tepat dari paket yang ingin Anda hapus.

Membersihkan

Setelah pengujian, Anda dapat menghapus proyek pengujian dan saluran lokal.

Untuk membersihkan sumber daya pengujian

  1. Hapus direktori proyek uji.

    Akti Linux f macOS kan dan, jalankan perintah berikut.

    rm -rf package-test-env

    Pada Windows (cmd), jalankan perintah berikut.

    rmdir /s /q package-test-env

  2. Hapus direktori saluran conda lokal.

    Akti Linux f macOS kan dan, jalankan perintah berikut.

    rm -rf $HOME/my-conda-channel

    Pada Windows (cmd), jalankan perintah berikut.

    rmdir /s /q %USERPROFILE%\my-conda-channel

  3. (Opsional) Hapus direktori rattler-build keluaran yang berisi file paket yang dibangun.

    Akti Linux f macOS kan dan, jalankan perintah berikut.

    rm -rf deadline-cloud-samples/conda_recipes/output

    Pada Windows (cmd), jalankan perintah berikut.

    rmdir /s /q deadline-cloud-samples\conda_recipes\output

Untuk plugin yang didukung dengan contoh sinkronisasi plugin, lihatSinkronkan plugin ke pekerja Deadline Cloud.