Pular para o conteúdo
OSX-REIMS
Documentação: Versão do Reims vGPU

Documentação · Uso

Versão do Reims vGPU

Versão testada ou mais recente: como escolher, atualizar e voltar.

Alfa

Esta documentação corresponde ao OSX-REIMS 0.3.0, em estágio alfa. Comandos e opções podem mudar entre versões; na dúvida, confira osx-reims --help na versão instalada.

O OSX-REIMS usa o Reims vGPU (abre em nova aba), baixado do repositório original para /opt/reims-vgpu e compilado no seu computador. Cada versão do OSX-REIMS é testada com um commit específico do Reims vGPU, mas você pode escolher qual versão seguir.

Testada ou mais recente

Versão O que é
Tested (testada) O commit testado com a sua versão do OSX-REIMS. É o padrão e a opção recomendada
Latest (mais recente) O commit mais novo do branch master do Reims vGPU, ainda não testado com o OSX-REIMS

No OSX-REIMS 0.3.0, a versão testada é o commit 69a57dd6, o mesmo da 0.2.0.

A escolha é feita na primeira execução do osx-reims setup e fica salva. O osx-reims doctor mostra qual versão o computador segue.

Atenção

A versão mais recente pode trazer correções e novidades, mas também pode não compilar ou impedir as VMs de iniciar. Se isso acontecer, volte para a testada.

Trocar de versão ou atualizar

Com todas as VMs desligadas, rode:

osx-reims update-reims

Ou, no console, escolha Maintenance › Update Reims vGPU. O comando:

  1. pergunta qual versão seguir, oferecendo a escolha atual;
  2. mostra o commit atual, o novo, quantos commits mudam e a versão seguida;
  3. pede confirmação; para uma versão não testada, a resposta padrão é não;
  4. baixa o novo commit e compila o Reims vGPU. A compilação leva alguns minutos, e as VMs não podem iniciar até ela terminar.

Se o Reims vGPU já estiver no commit escolhido, nada é compilado. Para compilar de novo mesmo assim, use osx-reims setup --rebuild.

Quem segue a versão mais recente não recebe commits novos sozinho: rode osx-reims update-reims de novo para buscar o commit mais novo do master. O setup mantém o commit que já está compilado.

Se a nova versão falhar

Se o novo commit não compilar ou não passar nas verificações, o update-reims volta para o commit que funcionava e o compila de novo, então as VMs continuam iniciando como antes. O log mostra o que falhou.

Se a nova versão compilar, mas as VMs não iniciarem com ela, volte para a testada:

osx-reims update-reims --tested

Ao instalar uma nova versão do OSX-REIMS

Uma nova versão do OSX-REIMS pode ser testada com outro commit do Reims vGPU. Se o computador segue a versão testada e ela mudou, a instalação do pacote avisa para rodar osx-reims update-reims, com as VMs desligadas. Se ele segue a mais recente ou um commit escolhido, a instalação lembra que a atualização fica por sua conta.

Commit específico (avançado)

A opção --reims-ref <ref> do setup e do update-reims aceita um commit, tag ou branch do Reims vGPU. Essa escolha não é testada e fica salva até você escolher --tested ou --latest.

Nota

Alterações locais em /opt/reims-vgpu interrompem o setup e o update-reims: nada é limpo nem desfeito automaticamente.