

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Crie e teste pacotes localmente
<a name="build-test-packages-locally"></a>

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](https://github.com/aws-deadline/deadline-cloud-samples) emGitHub. Você pode substituir uma receita diferente do repositório de amostras ou usar sua própria receita.

## Pré-requisitos
<a name="build-test-locally-prereqs"></a>

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](https://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 instalar`rattler-build`.

  ```
  pixi global install rattler-build
  ```
+ **git — Necessário** para clonar o repositório de amostras. WindowsAtivado, [o git for Windows](https://gitforwindows.org/) também fornece um `bash` shell, exigido por algumas das receitas de Windows amostra.

## Criando e publicando um pacote em um canal local
<a name="build-test-locally-build"></a>

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**

1. Clone o repositório de amostras do Deadline Cloud.

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

1. Mude para o diretório `conda_recipes`.

   ```
   cd deadline-cloud-samples/conda_recipes
   ```

1. 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](https://conda-forge.org/), 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 sobre`rattler-build publish`, consulte a documentação de publicação do [rattler-build](https://rattler-build.prefix.dev/latest/publish/).

## Compilações de depuração
<a name="build-test-locally-debug"></a>

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](https://rattler-build.prefix.dev/latest/debugging_builds/).

## Testando o pacote
<a name="build-test-locally-test"></a>

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**

1. 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
   ```

1. Adicione o pacote ao projeto.

   ```
   pixi add blender=4.5
   ```

1. 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](publish-packages-s3-channel.md).

## Limpeza
<a name="build-test-locally-cleanup"></a>

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

**Para limpar os recursos de teste**

1. 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
   ```

1. 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
   ```

1. (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
   ```