Pacotes e CI/CD (Visualização)

34 Bundles e CI/CD (Visualização)

Os pacotes definem como os recursos do Oracle AI Data Platform Workbench são empacotados, com controle de versão, compartilhados e implantados em espaços de trabalho e ambientes.

Você pode criar bundles para jobs e agentes. Um bundle é criado em uma pasta Git para que os arquivos do bundle possam ser confirmados e enviados para um repositório Git. Os recursos que você inclui no pacote podem vir de qualquer local do espaço de trabalho. Se os recursos selecionados fizerem referência a arquivos ou dependências de suporte, como notebooks, scripts ou computação, essas referências serão incluídas no pacote para que os recursos possam ser implantados em outro ambiente sem recriar manualmente os mesmos componentes.

Você cria pacotes do seu espaço de trabalho e seleciona os recursos do Oracle AI Data Platform Workbench a serem incluídos no momento da criação. Os bundles existentes podem ser modificados para adicionar ou remover recursos. O agrupamento de recursos permite agrupar jobs e agentes relacionados e implantá-los em outros ambientes com suas dependências intactas.

Você pode fazer commit e enviar bundles para seu repositório Git por meio de suas pastas Git. Os usuários podem, então, puxar os pacotes para seus próprios ambientes e implantá-los. As alterações nos arquivos de pacote ficam disponíveis para outros ambientes depois que as alterações são confirmadas e enviadas para o repositório Git. Sempre que os usuários extraem o pacote atualizado do repositório Git, eles recebem os arquivos de recursos confirmados mais recentes.

Conceitos do Pacote

Conceito	Definição	Ação do Usuário
Pasta Git	Uma pasta da Plataforma de Dados AI conectada a um repositório e uma ramificação Git. Os bundles só podem ser criados em pastas Git.	Crie ou abra uma pasta Git antes de criar um bundle.
Pacote	Um pacote implantável que define os recursos selecionados e suas dependências.	Crie o pacote no espaço de trabalho e selecione recursos como jobs ou fluxos de agentes.
Conteúdo de bundle	Arquivos gerados que descrevem recursos, variáveis, definições de destino e artefatos necessários para implantação.	Revise o conteúdo gerado após criar ou sincronizar. Confirme e envie o pacote pelo Git quando estiver pronto.
Target	Uma configuração de ambiente ou espaço de trabalho usada ao implantar o pacote fora do ambiente de origem.	Forneça valores que devem ser alterados por ambiente, como chave do espaço de trabalho, nome da credencial, chave do token ou padrões de parâmetro.
Item implantado	Um recurso criado ou atualizado por uma implantação de pacote no espaço de trabalho de destino.	Use a guia Implantação para implantar, revisar itens implantados, executar jobs e expurgar recursos implantados quando necessário.
Sincronização	Uma ação de bundle que atualiza recursos de bundle e dependências dos recursos de origem mais recentes.	Execute a sincronização após alterar os recursos agrupados e, em seguida, confirme os arquivos de pacote atualizados no Git.

Antes de Começar

Marque esta lista para ter certeza de que você tem tudo o que precisa para começar a usar os pacotes Git no espaço de trabalho da AI Data Platform:

Crie credenciais Git e uma pasta Git que aponte para o repositório e a ramificação usados para arquivos de bundle.
Confirme se os recursos de origem estão no espaço de trabalho e são salvos antes de criar ou sincronizar o pacote.
Para implantação entre ambientes, confirme se o espaço de trabalho de destino tem permissões e capacidade de computação necessárias.
Para jobs ou notebooks que usam segredos, crie as credenciais nomeadas necessárias no armazenamento de credenciais de destino. Os arquivos de pacote devem fazer referência a credenciais por nome ou variável, sem conter valores secretos.
Faça commit e envie alterações no arquivo do bundle após criar ou sincronizar um bundle para que outros ambientes possam extrair a definição de bundle mais recente.

Criar um bundle (visualização)

Você pode agrupar recursos de job e agente do Oracle AI Data Platform para criar um pacote que possa ser implantado em outra pasta do Git.

Navegue até o seu espaço de trabalho.
Clique em Ações e, em seguida, clique em Criar Pacote.
Informe um nome e descrição para o seu pacote.
Clique em Procurar e selecione a pasta Git no espaço de trabalho em que deseja criar o pacote.
Selecione os recursos que deseja incluir no pacote entre as opções listadas.
Clique em Criar.

Observação:
Os pacotes são criados em pastas Git. Se o local selecionado não estiver dentro de uma pasta Git, não será possível usar o Git para mover os arquivos de bundle gerados para outro ambiente.

Implantar um Pacote (Visualização)

Você pode implantar pacotes de uma pasta Git para compartilhar recursos e dependências entre espaços de trabalho e ambientes.

Navegue até o pacote que você deseja implantar no seu espaço de trabalho.
Clique na guia Implantação.
Opcional: Revise valores de destino e substituições, se aplicável.
Clique em Disponibilizar. Você é notificado quando a implantação é concluída.

Observação:
Na primeira implantação, a guia Implantação pode não mostrar itens implantados até que a implantação seja bem-sucedida. Após uma implantação bem-sucedida, revise os recursos implantados, execute jobs ou agentes conforme necessário e confirme a saída de runtime.

Limpar um bundle (visualização)

Você pode expurgar um pacote implantado para remover os recursos do pacote do seu espaço de trabalho.

Navegue até o pacote cujos recursos você deseja expurgar em seu espaço de trabalho.
Clique na guia Implantação.
Clique em Expurgar.
Digite Expurgar no prompt. Clique em Expurgar.