build-kit-locally

Habilidade: Construir e Publicar Kit Localmente

Propósito

Construir um kit Bottlerocket (core-kit ou kernel-kit) e publicá-lo em um registro OCI local para testes e validação de desenvolvimento. Isso permite testar alterações no kit em builds de variantes sem publicar em registros de produção.

Quando Usar

• Fazendo alterações nos pacotes do kit e testando-os em variantes
• Desenvolvimento iterativo em kits
• Antes de construir uma imagem de variante que depende de alterações no kit

Pré-requisitos

• Docker instalado e em execução
• Trabalhando a partir de um diretório grove
• Repositório do kit clonado no diretório kits/

Procedimento

1. Garanta que o registro local esteja em execução

brdev registry start

2. Configure para o registro local

cd kits/<nome-do-kit>
brdev twoliter use-local-publish

Isso cria Infra.toml apontando para o registro local para publicação.

3. Construa o kit

make build

Para uma arquitetura específica:

make build ARCH=x86_64
# ou
make build ARCH=aarch64

4. Publique no registro local

make publish VENDOR=local

Isso publica o kit em localhost:5000 com o prefixo de fornecedor "local".

5. Verifique a publicação

brdev registry list

Deve exibir seu kit na lista de repositórios.

Validação

Verifique se o kit está disponível:

brdev registry list

Deve retornar as tags de versão publicadas.

Problemas Comuns

Registro não em execução:

Erro: conexão recusada

Solução: Execute brdev registry start

Infra.toml não configurado:

Erro: fornecedor 'local' não encontrado

Solução: Execute brdev twoliter use-local-publish para criar a configuração

Permissão negada no Docker: Solução: Certifique-se de que o usuário está no grupo docker e o daemon do Docker está em execução

Próximos Passos

Após publicar um kit:

1. Atualize o Twoliter.toml da variante para referenciar a nova versão do kit
2. Execute make update no repositório da variante
3. Construa a variante com cargo make