Habilidade: Testar Alterações Locais no Twoliter
Propósito
Compilar o twoliter a partir do código-fonte local e configurar os kits para usar o binário compilado localmente, permitindo testar alterações antes do lançamento.
Quando Usar
- Fazendo alterações no código-fonte do twoliter
- Testando modificações no twoliter antes de criar um PR
- Depurando o comportamento do twoliter
- Validando correções no twoliter
Pré-requisitos
- Repositório twoliter clonado no forest
- Toolchain Rust instalada
- Pelo menos um repositório de kit para testar
Procedimento
1. Faça alterações no código-fonte do twoliter
Edite os arquivos em twoliter/twoliter/src/ ou twoliter/twoliter/embedded/.
2. Compile o twoliter
cd twoliter
cargo build --release
O binário estará em target/release/twoliter.
3. Teste as alterações
Sobrescreva TWOLITER_DIR para apontar para o diretório de build local:
cd kits/bottlerocket-core-kit
make build TWOLITER_DIR=./twoliter/target/release
4. Itere
Após mais alterações:
# Recompile o twoliter
cd ./twoliter
cargo build --release
# Teste novamente
cd kits/bottlerocket-core-kit
make build TWOLITER_DIR=./twoliter/target/release
Validação
Verifique se o twoliter local está sendo usado conferindo o caminho:
cd kits/bottlerocket-core-kit
make build TWOLITER_DIR=./twoliter/target/release 2>&1 | head -5
Você deve ver seu twoliter modificado sendo invocado.
Problemas Comuns
Alterações não estão surtindo efeito:
- Certifique-se de executar
cargo build --releaseapós fazer alterações - Verifique se o caminho em
TWOLITER_DIRestá correto - Confirme que o binário existe:
ls -lh ./twoliter/target/release/twoliter
Erros de compilação no twoliter:
- Execute
cargo checkpara ver mensagens de erro detalhadas - Execute
cargo clippypara detectar problemas comuns - Execute
cargo testpara verificar se os testes passam
Falha no build do kit com o twoliter local:
- Verifique a saída do twoliter em busca de mensagens de erro
- Adicione
--log-level debugmodificando temporariamente o Makefile ou usando o binário twoliter diretamente
Revertendo para a Versão Lançada
Para voltar a usar a versão lançada, basta omitir a sobrescrita de TWOLITER_DIR:
cd kits/bottlerocket-core-kit
make build
Isso usará o tools/twoliter/twoliter padrão da versão lançada.