Guia do Cloud

O Cloud executa tarefas remotamente. Inicie uma tarefa selecionando um repositório ou mova uma tarefa local existente para a nuvem e acompanhe o trabalho por um cliente disponível com suporte ao Cloud.

Este guia usa o aplicativo desktop como interface principal. Também inclui comandos da CLI para mover uma tarefa local para o Cloud e conferir o status da transferência.

flowchart TD
    A["Check account and repository access"] --> B{"Where will you start?"}
    B --> C["Select a repository and start a cloud task"]
    B --> D["Open an existing local task"]
    D --> E["Review conversation and uncommitted changes to transfer"]
    C --> F["Cloud prepares and runs the task"]
    E --> F
    F --> G["Follow progress, add context, and review results"]
    G --> H["Refine the work or deliver it through a PR"]

1. Antes de começar

1.1 Conta e clientes

Os exemplos deste guia usam repositórios do GitHub. Para instalação e login, consulte o Guia do desktop.

1.2 Escolha como começar

2. Conecte seu repositório e confira os requisitos

2.1 Conecte o GitHub

1. Abra o seletor de projetos no aplicativo desktop e encontre Cloud.
2. Se o Cloud não estiver disponível, clique no botão de configurações ao lado dele para abrir a página de conexão com o GitHub.
3. Siga as instruções da página para autorizar o GitHub.
4. Volte ao seletor de projetos, abra Cloud e confira se o repositório de destino está listado.

Use Buscar repositórios para encontrar um repositório. Se ele não aparecer, confira a conta do GitHub conectada e os repositórios que ela está autorizada a acessar.

2.2 Confira o repositório e a branch

Ao selecionar um repositório, o Remy começa pela branch padrão dele. Para usar outra, abra o seletor de branches e escolha aquela de onde a tarefa deve partir.

2.3 Como o Cloud prepara o ambiente

Depois que você envia uma tarefa, o Cloud prepara o espaço de trabalho, obtém o código do repositório e inicia a execução conforme necessário. Esse fluxo não exige que você crie um ambiente de nuvem com nome separado.

Não presuma que dependências instaladas no computador, servidores de desenvolvimento locais e credenciais locais existem no Cloud. Se a tarefa precisar de dependências especiais, explique como prepará-las e verificá-las na documentação do projeto ou na descrição da tarefa.

Leia primeiro o README do repositório e as instruções do projeto.
Confirme como instalar dependências, executar o projeto e executar seus testes.
Se faltar algo obrigatório no ambiente, identifique o que falta e inclua o erro relevante.
Execute as verificações possíveis e liste separadamente quaisquer verificações que não puder executar.

3. Inicie uma tarefa diretamente no Cloud

3.1 Selecione um repositório e envie a tarefa

1. Inicie uma nova conversa e abra Cloud no seletor de projetos.
2. Encontre e selecione o repositório de destino e confira a branch.
3. Confirme que a configuração de execução mostra Enviar para a nuvem.
4. Escolha um modelo disponível, descreva a tarefa e envie-a.
5. Aguarde a inicialização e a execução e revise o progresso e os resultados.

Para revisar um plano primeiro, ative Planejar antes de editar no menu de execução antes de enviar a tarefa. Leia o plano e confirme-o ou explique na conversa as alterações desejadas.

3.2 Deixe os requisitos claros

Adapte este exemplo ao seu projeto:

Encontre e corrija o problema de paginação que ocorre quando os filtros mudam na lista de pedidos.

Requisitos:
1. Leia primeiro a documentação do repositório e as instruções relevantes.
2. Altere somente a filtragem, a paginação e a lógica diretamente relacionada.
3. Siga os estilos e as convenções de teste existentes no projeto.
4. Adicione e execute os testes relevantes.
5. Resuma os arquivos alterados, os resultados das verificações e qualquer trabalho restante.

Não faça o merge do PR.

3.3 Mensagens de texto e anexos locais

As mensagens de tarefa enviadas diretamente ao Cloud atualmente aceitam apenas texto. Anexos locais, referências a pastas e referências a código local não podem ser enviados com essas mensagens.

4. Mova uma tarefa local para o Cloud

4.1 Inicie a transferência no aplicativo desktop

1. Abra a conversa local que deseja continuar e confira o projeto e a tarefa atuais.
2. Aguarde a execução local atual terminar.
3. Abra o menu da aba da conversa e escolha Mover para o Cloud.
4. Se houver arquivos sem commit, revise a quantidade, a lista e o tamanho estimado da transferência e escolha se deseja incluí-los.
5. Confira o repositório, o commit e outros detalhes de confirmação exibidos e siga as instruções.
6. Aguarde a transferência ser concluída com sucesso e acompanhe a execução na nuvem na tarefa original.

Se o GitHub não estiver autorizado, conclua a autorização pela opção de configurações antes de tentar novamente.

4.2 Escolha se deseja incluir alterações sem commit

Quando aparecer Incluir alterações sem commit?:

Essa escolha determina se as alterações sem commit serão incluídas. Revise o escopo de arquivos exibido antes de continuar; não presuma que a pasta local inteira será enviada.

4.3 O que muda depois da transferência

Uma transferência bem-sucedida não significa que a tarefa está concluída. Depois de movê-la para o Cloud, aguarde a execução, revise os resultados e resolva qualquer trabalho de acompanhamento.

4.4 Inicie uma transferência pela CLI

Em um terminal no qual já tenha entrado na CLI, liste as conversas do projeto de destino:

remy --workspace "/path/to/project" history list

Substitua /path/to/project pelo caminho real do projeto e CHAT_ID abaixo pelo ID da conversa relevante.

Incluir alterações sem commit:

remy --workspace "/path/to/project" cloud handoff --chat-id "CHAT_ID" --include-workspace --message "Continue as verificações restantes na nuvem e relate os resultados."

Manter alterações sem commit localmente:

remy --workspace "/path/to/project" cloud handoff --chat-id "CHAT_ID" --exclude-workspace --message "Continue a tarefa na nuvem usando o código com commit."

Escolha o comando adequado à tarefa. Se o diretório de trabalho não tiver alterações sem commit, você pode omitir tanto --include-workspace quanto --exclude-workspace.

A CLI mostra uma prévia da transferência. Confira o escopo da conta, o repositório, a branch, o commit e o escopo dos arquivos e digite yes para confirmar.

4.5 Confira ou cancele uma transferência

Se uma transferência ainda estiver em andamento, confira seu status:

remy --workspace "/path/to/project" cloud status --chat-id "CHAT_ID"

Se você já tiver o ID da transferência, pode especificá-lo explicitamente:

remy --workspace "/path/to/project" cloud status --chat-id "CHAT_ID" --handoff-id "HANDOFF_ID"

Substitua HANDOFF_ID pelo ID retornado para essa operação. Se a conexão cair depois do envio ou o resultado for desconhecido, confira primeiro essa mesma transferência em vez de iniciar uma nova.

Para cancelar uma transferência antes que a tarefa na nuvem seja ativada:

remy --workspace "/path/to/project" cloud cancel --chat-id "CHAT_ID" --handoff-id "HANDOFF_ID"

Esse comando cancela somente uma transferência que ainda não ativou uma tarefa na nuvem. Ele não pode cancelar uma tarefa já ativada. Para uma tarefa que já esteja executando no Cloud, abra-a no aplicativo desktop e use o controle de parada da tarefa.

O comando cloud status da CLI verifica a transferência. Use a interface da tarefa no desktop para acompanhar todo o progresso, continuar a conversa e realizar ações de PR.

5. Acompanhe tarefas e trabalhe em vários dispositivos

5.1 Entenda a etapa atual

Depois de solicitar a parada, aguarde a atualização do status da tarefa e confirme que a execução na nuvem terminou.

5.2 Continue na tarefa original

Para refinar um resultado, abra a mesma tarefa na nuvem e explique o que precisa mudar:

Alterar os filtros agora retorna a lista à página 1, mas a lista não é atualizada.
Corrija somente a lógica de atualização e preserve as alterações já concluídas.
Adicione e execute os testes relevantes e resuma os resultados.

Não faça o merge do PR.

Depois de uma interrupção de rede, reabra a tarefa original e confira o status atual e a resposta mais recente antes de decidir se deve reenviar uma mensagem. Se a lista de tarefas não for atualizada, ela ainda poderá mostrar os últimos registros obtidos.

5.3 Continue em outro dispositivo

1. Entre no Remy Desktop em outro dispositivo com a mesma conta e confirme o mesmo escopo de equipe.
2. Encontre a tarefa na nuvem na barra lateral.
3. Abra-a e aguarde o carregamento das mensagens e do status mais recentes.
4. Revise os resultados ou acrescente requisitos na mesma tarefa.

O computador que iniciou a tarefa não precisa permanecer online. As tarefas do Cloud podem continuar depois que você fecha o aplicativo desktop, fica offline ou desliga o computador. Perguntas que precisam da sua resposta ficarão aguardando.

Trabalhe em vários dispositivos usando qualquer cliente com suporte ao Cloud.

6. Revise e entregue resultados

6.1 Confira os resultados da tarefa

Um resultado de tarefa ou um PR gerado não substitui a conferência dos testes e do comportamento real.

6.2 Entregue o trabalho por meio de um PR

Se precisar de um PR, diga isso na tarefa. Por exemplo:

Prepare um PR para as alterações concluídas.
Descreva o problema resolvido, as principais alterações, as verificações executadas e qualquer trabalho restante.
Se esta tarefa já tiver um PR, atualize esse PR.

Não faça o merge dele.

Quando a tarefa cria um PR, aparece um cartão de PR em rascunho ou PR. Clique no link para abrir o PR no navegador e revisar a branch de trabalho, a branch de destino e o diff real.

Para fazer o merge pelo Remy, revise o PR primeiro e escolha Fazer merge do PR no cartão. Confira as branches de origem e destino na caixa de confirmação antes de continuar. O merge altera o repositório remoto; use o status retornado para confirmar o resultado.

6.3 Sua pasta local não é atualizada automaticamente

Os resultados do Cloud não são sincronizados automaticamente com o diretório de trabalho local. Depois de fazer o merge de um PR, ou quando quiser retomar o trabalho local, obtenha e inspecione o código usando o fluxo habitual de Git do projeto.

O painel local Alterações não necessariamente mostra as alterações mais recentes da tarefa na nuvem.

7. Solução de problemas e limitações conhecidas

7.1 Acesso, execução e resultados

7.2 Limites atuais

• Uma transferência do ambiente local para a nuvem segue a prévia e o escopo selecionado. Ela não copia o computador inteiro nem o ambiente de execução local.
• As mensagens que iniciam ou continuam tarefas do Cloud atualmente aceitam apenas texto.
• Sua escolha de transferência determina se os arquivos locais sem commit serão incluídos.
• Conferir uma transferência na CLI é diferente de acompanhar a execução da tarefa na nuvem.
• Os resultados do Cloud não são sincronizados automaticamente com o ambiente local. Confirme a entrega conferindo o código real, os resultados das verificações e o status do PR.

8. Obtenha ajuda e continue explorando

8.1 Relate um problema

Use Enviar feedback na tarefa relevante. Para os comandos de feedback da CLI, consulte o Guia da CLI.

Especifique se o problema ocorreu ao iniciar uma tarefa, mover um trabalho local para o Cloud, acompanhar uma tarefa ou entregar um PR. Inclua o repositório e a branch, qualquer ID de tarefa ou transferência e a mensagem de erro.

Se não conseguir abrir a tarefa ou usar a opção de feedback, entre em contato com o suporte em support@corepass.com.

8.2 Continue explorando