GitHub Codespaces

Tradução assistida por IA - saiba mais e sugira melhorias

GitHub Codespaces é uma plataforma baseada na web que nos permite fornecer um ambiente pré-configurado para treinamento, suportado por máquinas virtuais na nuvem. A plataforma é operada pelo GitHub (que pertence à Microsoft) e está acessível gratuitamente (com cotas de uso) para qualquer pessoa com uma conta GitHub.

Aviso

Contas vinculadas a organizações podem estar sujeitas a certas restrições adicionais. Se esse for o seu caso, você pode precisar usar uma conta pessoal independente ou usar uma instalação local.

Criando uma conta GitHub

Você pode criar uma conta GitHub gratuita na página inicial do GitHub.

Iniciando seu GitHub Codespace

Depois de fazer login no GitHub, abra este link no seu navegador para abrir o ambiente de treinamento Nextflow: https://codespaces.new/nextflow-io/training?quickstart=1&ref=master

Como alternativa, você pode clicar no botão mostrado abaixo, que é repetido em cada curso de treinamento (normalmente na página de Orientação).

Você deve ver uma página onde pode criar um novo GitHub Codespace:

Configuração

Para uso geral, você não deve precisar configurar nada. A menos que seja especificado de outra forma no curso que você está iniciando, você pode simplesmente clicar no botão principal para continuar.

No entanto, é possível personalizar o ambiente clicando no botão "Change options".

Opções de configuração

Se você clicar no botão "Change options", terá a opção de personalizar o seguinte:

Branch

Isso permite que você selecione uma versão diferente dos materiais de treinamento. O branch master geralmente contém correções de bugs e materiais que foram desenvolvidos e aprovados recentemente, mas ainda não foram lançados no site. Outros branches contêm trabalhos em andamento que podem não estar totalmente funcionais.

Machine type

Isso permite que você personalize a máquina virtual que usará para trabalhar no treinamento.

Usar uma máquina com mais núcleos permite aproveitar melhor a capacidade do Nextflow de paralelizar a execução do fluxo de trabalho. No entanto, isso consumirá sua cota gratuita mais rapidamente, então não recomendamos alterar esta configuração, a menos que seja aconselhado nas instruções do curso que você planeja fazer.

Veja 'Cotas do GitHub Codespaces' abaixo para mais detalhes sobre cotas.

Tempo de inicialização

Abrir um novo ambiente GitHub Codespaces pela primeira vez pode levar vários minutos, porque o sistema precisa configurar sua máquina virtual, então não se preocupe se houver um tempo de espera. No entanto, não deve levar mais de cinco minutos.

Navegando pela interface de treinamento

Depois que seu GitHub Codespaces carregar, você deve ver algo semelhante ao seguinte (que pode abrir no modo claro, dependendo das preferências da sua conta):

Esta é a interface do VSCode IDE, uma aplicação popular de desenvolvimento de código que recomendamos usar para o desenvolvimento com Nextflow.

• O editor principal é onde o código Nextflow e outros arquivos de texto serão abertos. É aqui que você editará o código. Quando você abrir o codespace, isso mostrará uma prévia do arquivo README.md.
• O terminal abaixo do editor principal permite executar comandos. É aqui que você executará todas as linhas de comando fornecidas nas instruções do curso.
• A barra lateral permite personalizar seu ambiente e realizar tarefas básicas (copiar, colar, abrir arquivos, pesquisar, git, etc.). Por padrão, ela está aberta no explorador de arquivos, que permite navegar pelo conteúdo do repositório. Clicar em um arquivo no explorador o abrirá na janela do editor principal.

Você pode ajustar as proporções relativas dos painéis da janela como preferir.

Outras observações sobre o uso do GitHub Codespaces

Retomando uma sessão

Depois de criar um ambiente, você pode facilmente retomá-lo ou reiniciá-lo e continuar de onde parou. Seu ambiente expirará após 30 minutos de inatividade e salvará suas alterações por até 2 semanas.

Você pode reabrir um ambiente em https://github.com/codespaces/. Os ambientes anteriores serão listados. Clique em uma sessão para retomá-la.

Se você salvou a URL do seu ambiente GitHub Codespaces anterior, pode simplesmente abri-la no seu navegador. Como alternativa, clique no mesmo botão que você usou para criá-lo inicialmente:

Você deve ver a sessão anterior, a opção padrão é retomá-la:

Salvando arquivos na sua máquina local

Para salvar qualquer arquivo do painel explorador, clique com o botão direito no arquivo e selecione Download.

Gerenciando cotas do GitHub Codespaces

GitHub Codespaces oferece até 15 GB-mês de armazenamento por mês e 120 horas-núcleo por mês. Isso é equivalente a cerca de 60 horas de tempo de execução do ambiente padrão usando o espaço de trabalho padrão (2 núcleos, 8 GB de RAM e 32 GB de armazenamento).

Você pode criá-los com mais recursos (veja a explicação acima), mas isso consumirá seu uso gratuito mais rapidamente e você terá menos horas de acesso a este espaço. Por exemplo, se você selecionar uma máquina de 4 núcleos em vez do padrão de 2 núcleos, sua cota se esgotará na metade do tempo.

Opcionalmente, você pode comprar acesso a mais recursos.

Para mais informações, consulte a documentação do GitHub: About billing for GitHub Codespaces