Pré-requisitos Criando e publicando um pacote em um canal local Compilações de depuração Testando o pacote Limpeza

Crie e teste pacotes localmente

Antes de publicar pacotes no Amazon S3 ou configurar a CI/CD automação em seu farm Deadline Cloud, você pode criar e testar pacotes conda em sua estação de trabalho usando um canal de sistema de arquivos local. Essa abordagem permite que você itere rapidamente as receitas localmente e verifique os pacotes.

O rattler-build publish comando cria uma receita, copia o pacote resultante em um canal e indexa o canal em uma única etapa. Quando você direciona um diretório do sistema de arquivos local, rattler-build cria e inicializa o canal automaticamente se o diretório não existir.

As instruções a seguir usam a receita de amostra Blender 4.5 do repositório de amostras do Deadline Cloud emGitHub. Você pode substituir uma receita diferente do repositório de amostras ou usar sua própria receita.

Pré-requisitos

Antes de começar, instale as seguintes ferramentas em sua estação de trabalho:

pixi — Um gerenciador de pacotes que você usa para instalar rattler-build e testar pacotes. Instale o pixi a partir do pixi.sh.
rattler-build — A ferramenta de criação de pacotes usada pelas receitas do Deadline Cloud conda. Depois de instalar o pixi, execute o seguinte comando para instalarrattler-build.
```
pixi global install rattler-build
```
git — Necessário para clonar o repositório de amostras. WindowsAtivado, o git for Windows também fornece um bash shell, exigido por algumas das receitas de Windows amostra.

Criando e publicando um pacote em um canal local

Neste procedimento, você clona o repositório de amostras do Deadline Cloud e o usa rattler-build publish para criar e publicar o pacote em um canal de sistema de arquivos local.

Para criar e publicar um pacote em um canal local

Clone o repositório de amostras do Deadline Cloud.


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

Mude para o diretório conda_recipes.
```
cd deadline-cloud-samples/conda_recipes
```
Execute o comando a seguir para criar a receita Blender 4.5 e publicar o pacote em um diretório de canal local.

Em Linux emacOS, execute o comando a seguir.
```
rattler-build publish blender-4.5/recipe/recipe.yaml \
    --to file://$HOME/my-conda-channel
```
Em Windows (cmd), execute o comando a seguir.
```
rattler-build publish blender-4.5/recipe/recipe.yaml ^
    --to file://%USERPROFILE%/my-conda-channel
```
O rattler-build publish comando executa as seguintes ações:
- Cria o pacote a partir da receita.
- Cria o diretório do canal se o diretório não existir.
- Copia o arquivo do pacote para o canal.
- Indexa o canal para que os gerenciadores de pacotes possam encontrar o pacote.
Se a receita do pacote depender de pacotes de um canal específico, como conda-forge, adicione -c conda-forge ao comando.

Para reconstruir o pacote depois de fazer alterações na receita, adicione --build-number=+1 para incrementar automaticamente o número da compilação.


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

Para obter mais informações sobrerattler-build publish, consulte a documentação de publicação do rattler-build.

Compilações de depuração

Se uma compilação falhar, rattler-build preserva o diretório de compilação para que você possa investigar. Execute o comando a seguir para abrir um shell interativo no ambiente de compilação com todas as variáveis de ambiente configuradas como estavam durante a compilação.


rattler-build debug shell

No shell de depuração, você pode modificar arquivos, executar comandos de compilação individuais e adicionar dependências para isolar o problema. Para obter mais informações, consulte Depuração de compilações na documentação do rattler-build.

Testando o pacote

Depois de criar e publicar o pacote, crie um projeto pixi temporário. Use o projeto para instalar o pacote a partir do canal local e verificar se ele funciona corretamente.

Para testar o pacote

Crie um diretório de teste temporário e inicialize um projeto pixi com o canal local.

LinuxAtivado emacOS, execute os seguintes comandos.


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

Em Windows (cmd), execute os seguintes comandos.


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

Adicione o pacote ao projeto.
```
pixi add blender=4.5
```
Verifique se o pacote funciona corretamente.
```
pixi run blender --version
```

Quando estiver satisfeito com o pacote, você pode publicá-lo em um canal conda do Amazon S3 para que os funcionários do Deadline Cloud possam instalar o pacote. Consulte Publicar pacotes em um canal conda do S3.

Limpeza

Após o teste, você pode remover o projeto de teste e o canal local.

Para limpar os recursos de teste

Remova o diretório do projeto de teste.

Em Linux emacOS, execute o comando a seguir.
```
rm -rf package-test-env
```
Em Windows (cmd), execute o comando a seguir.
```
rmdir /s /q package-test-env
```
Remova o diretório local do canal conda.

Em Linux emacOS, execute o comando a seguir.
```
rm -rf $HOME/my-conda-channel
```
Em Windows (cmd), execute o comando a seguir.
```
rmdir /s /q %USERPROFILE%\my-conda-channel
```
(Opcional) Remova o diretório rattler-build de saída que contém o arquivo do pacote criado.

Em Linux emacOS, execute o comando a seguir.
```
rm -rf deadline-cloud-samples/conda_recipes/output
```
Em Windows (cmd), execute o comando a seguir.
```
rmdir /s /q deadline-cloud-samples\conda_recipes\output
```

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Crie um canal conda usando o S3

Publique pacotes em um canal conda do Amazon S3