在本機建置和測試套件

在將套件發佈至 Amazon S3 或在截止日期雲端陣列上設定 CI/CD 自動化之前，您可以使用本機檔案系統頻道在工作站上建置和測試 conda 套件。此方法可讓您在配方上於本機快速迭代並驗證套件。

rattler-build publish 命令會建置配方、將產生的套件複製到頻道，並在一個步驟中為頻道編製索引。當您以本機檔案系統目錄為目標時，如果目錄不存在， 會自動rattler-build建立和初始化頻道。

下列指示使用來自 上 Deadline Cloud 範例儲存庫的 Blender4.5 範例配方。 https://github.com/aws-deadline/deadline-cloud-samples GitHub您可以取代與範例儲存庫不同的配方，或使用您自己的配方。

先決條件

開始之前，請在工作站上安裝下列工具：

• pixi – 用於安裝rattler-build和測試套件的套件管理員。從 pixi.sh 安裝 pixi。

• rattler-build – Deadline Cloud conda 配方所使用的套件建置工具。安裝 pixi 之後，請執行下列命令來安裝 rattler-build。

  pixi global install rattler-build

• git – 複製範例儲存庫時需要。在 上Windows，適用於 的 git Windows 也提供 bash shell，其中一些Windows範例配方需要。

建置套件並將其發佈至本機頻道

在此程序中，您會複製截止日期雲端範例儲存庫，並使用 rattler-build publish來建置和發佈套件至本機檔案系統頻道。

建置套件並將其發佈至本機頻道

1. 複製截止日期雲端範例儲存庫。

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

2. 切換至 conda_recipes 目錄。

   cd deadline-cloud-samples/conda_recipes

3. 執行下列命令來建置 Blender 4.5 配方，並將套件發佈至本機頻道目錄。

   在 Linux和 macOS上執行下列命令。

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

   在 Windows(cmd) 上執行下列命令。

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

   rattler-build publish 命令會執行下列動作：

   • 從配方建置套件。

   • 如果目錄不存在，則建立頻道目錄。

   • 將套件檔案複製到頻道。

   • 為頻道編製索引，讓套件管理員可以找到套件。

   如果您的套件配方取決於來自特定頻道的套件，例如 conda-forge，請將 -c conda-forge新增至 命令。

若要在變更配方後重建套件，請新增 --build-number=+1 以自動增加建置編號。

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

如需 的詳細資訊rattler-build publish，請參閱 rattler-build 發佈文件。

偵錯組建

如果建置失敗， 會rattler-build保留建置目錄，以便您進行調查。執行下列命令，在建置環境中開啟互動式 Shell，並在建置期間設定所有環境變數。

rattler-build debug shell

從偵錯 shell，您可以修改檔案、執行個別建置命令，以及新增相依性來隔離問題。如需詳細資訊，請參閱 rattler-build 文件中的偵錯組建。

測試套件

在您建置和發佈套件之後，請建立臨時 pixi 專案。使用 專案從本機頻道安裝套件，並驗證其是否正常運作。

測試套件

1. 建立暫時測試目錄，並使用本機頻道初始化 pixi 專案。

   在 Linux和 macOS上執行下列命令。

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

   在 Windows(cmd) 上執行下列命令。

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

2. 將套件新增至專案。

   pixi add blender=4.5

3. 驗證套件是否正常運作。

   pixi run blender --version

當您對套件感到滿意時，您可以將套件發佈到 Amazon S3 conda 頻道，以便截止日期雲端工作者可以安裝套件。請參閱將套件發佈至 S3 conda 頻道。

清除

測試之後，您可以移除測試專案和本機頻道。

清除測試資源

1. 移除測試專案目錄。

   在 Linux和 macOS上執行下列命令。

   rm -rf package-test-env

   在 Windows(cmd) 上執行下列命令。

   rmdir /s /q package-test-env

2. 移除本機 conda 頻道目錄。

   在 Linux和 macOS上執行下列命令。

   rm -rf $HOME/my-conda-channel

   在 Windows(cmd) 上執行下列命令。

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

3. （選用） 移除包含建置套件檔案的rattler-build輸出目錄。

   在 Linux和 macOS上執行下列命令。

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

   在 Windows(cmd) 上執行下列命令。

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