Sobre os GitHub Codespaces
O GitHub Codespaces é um ambiente de desenvolvimento instantâneo e baseado na nuvem que usa um contêiner para fornecer linguagens, ferramentas e utilitários de desenvolvimento comuns. O GitHub Codespaces também é configurável, o que permite que você crie um ambiente de desenvolvimento personalizado que seja semelhante para todos os usuários do seu projeto. Confira Guia Rápido para GitHub Codespaces.
Depois que GitHub Codespaces estiver ativado em uma organização ou empresa, os usuários poderão criar um codespace a partir de qualquer branch ou commit de um repositório dessa organização ou empresa e começar a desenvolver utilizando recursos de computação em nuvem. Você pode conectar-se a um codespace por meio do navegador ou localmente usando o Visual Studio Code.
Para começar a usar o GitHub Codespaces, confira Guia Rápido para GitHub Codespaces. Para obter mais informações sobre como criar um codespace, confira Como criar um codespace para um repositório ou Como criar um codespace com base em um modelo. Se você quiser retornar a um codespace que já criou, confira Como abrir um codespace existente. Para saber mais sobre como funciona o GitHub Codespaces, confira Aprofundamento de GitHub Codespaces.
Definir o GitHub Codespaces como o editor preferencial para uma tarefa do GitHub Classroom é benéfico para alunos e professores. O GitHub Codespaces é uma boa opção para estudantes que usam dispositivos emprestados ou sem acesso a uma configuração de IDE local, já que cada codespace é baseado em nuvem e não requer nenhuma configuração local. Os alunos podem iniciar um codespace para um repositório de tarefas no Visual Studio Code diretamente no navegador e começar a desenvolver imediatamente sem precisar de mais configurações.
Para atribuições com ambientes de configuração complexos, os professores podem personalizar a configuração do contêiner de desenvolvimento nos Codespaces de um repositório. Isso garante que, quando um aluno cria um codespace, ele é aberto automaticamente com o ambiente de desenvolvimento configurado pelo professor. Para saber mais sobre contêineres de desenvolvimento, confira Introdução aos contêineres de desenvolvimento.
Observação
Codespaces individuais serão excluídos automaticamente se forem parados e deixados sem uso por um período prolongado. Confira Como configurar a exclusão automática de seus codespaces.
Os alunos verificados têm direito, para as próprias contas pessoais, ao uso gratuito dos GitHub Codespaces, até 180 horas de núcleo por mês. A quantidade mensal de armazenamento e horas de núcleo de uso disponíveis para os alunos é equivalente ao valor incluído nas contas do GitHub Pro. Para saber mais, confira Cobrança do GitHub Codespaces.
Observação
Se os alunos usarem GitHub Codespaces nos repositórios de atribuição do GitHub Classroom, o uso será cobrado da organização proprietária da sala de aula e não afetará o uso da conta pessoal do aluno.
Sobre o Benefício Educacional do Codespaces para Professores Verificados
O benefício educacional do Codespaces oferece aos professores autenticados um subsídio mensal gratuito de GitHub Codespaces horas para uso no GitHub Classroom. Estima-se que a cota gratuita seja suficiente para uma turma de 50 pessoas com 5 tarefas por mês, em uma máquina de 2 núcleos com 1 codespace armazenado por aluno.
Observação
O benefício do Codespaces para Educação está em versão prévia pública e está sujeito a alterações. Durante o uso do versão prévia pública, sua organização não será cobrada se você exceder o limite de gratuidade.
Para se tornar um professor verificado, você precisa ser aprovado para um benefício de professor ou educador. Confira Inscreva-se no GitHub Education como professor.
Depois de confirmar que você é um professor verificado, visite o GitHub Education for Teachers para atualizar a organização para o GitHub Team. Consulte Produtos do GitHub.
Se você estiver qualificado para o benefício de Educação do Codespaces, ao habilitar o GitHub Codespaces no GitHub Classroom para sua organização, o GitHub adicionará automaticamente uma política de Codespaces para restringir os tipos de máquina de todos os codespaces na organização a máquinas de dois núcleos. Isso ajudará você a aproveitar ao máximo do uso gratuito do GitHub Codespaces. No entanto, você poderá alterar ou remover essas políticas nas configurações da sua organização. Confira Restringindo o acesso aos tipos de máquina.
Quando o benefício educacional do Codespaces sair da prévia pública, se sua organização exceder a cota gratuita para uso do GitHub Codespaces, será cobrado pelo uso adicional. Confira Cobrança do GitHub Codespaces.
Habilitando Codespaces para a sua organização
O GitHub Codespaces está disponível para uso com o GitHub Classroom em organizações que utilizam o GitHub Team. Se você estiver qualificado para o benefício educacional do Codespaces, deverá habilitar o GitHub Codespaces por meio do GitHub Classroom, em vez de habilitá-lo diretamente nas configurações da sua organização. Caso contrário, sua organização será cobrada diretamente por todo o uso do GitHub Codespaces.
Habilitar o Codespaces em uma organização ao criar uma sala de aula
- Efetue o login em GitHub Classroom.
- No lado direito da página, clique em Nova sala de aula.
- Na lista de organizações, clique na organização que você gostaria de usar para a sua sala de aula. As organizações qualificadas para o GitHub Codespaces terão uma observação mostrando que estão qualificadas. Opcionalmente, você pode criar uma nova organização. Confira Criar uma organização do início.
- Na página "Nomear sua sala de aula", em "Codespaces em sua sala de aula", clique em Habilitar. Observe que isso habilitará o GitHub Codespaces para todos os repositórios e usuários da organização.
- Quando estiver pronto para criar a sala de aula, clique em Criar sala de aula.
Habilitar o Codespaces para uma organização por meio de uma sala de aula existente
-
Efetue o login em GitHub Classroom.
-
Na lista de salas de aula, clique na sala de aula que você deseja visualizar.
-
No nome da sala de aula, clique em Settings.
-
Em "GitHub Codespaces", clique em Habilitar. Isso habilitará o GitHub Codespaces para todos os repositórios e usuários da organização. Uma nova política do Codespace também será adicionada para restringir os tipos de computador para todos os codespaces da organização a computadores com dois núcleos.
Você também pode usar os mesmos métodos acima para desabilitar o GitHub Codespaces em sua organização. Esteja ciente de que isso desabilitará o GitHub Codespaces de todos os repositórios e usuários da organização.
Configurando uma atribuição para usar o Codespaces
Para disponibilizar o GitHub Codespaces aos alunos para uma tarefa, você pode escolher o GitHub Codespaces como o editor com suporte para a tarefa. Ao criar uma nova atribuição, na página "Adicionar seu código inicial e escolher um IDE online opcional", em "Adicionar um editor com suporte", selecione GitHub Codespaces no menu suspenso.
Se você usar um repositório de modelos para uma tarefa, poderá definir um contêiner de desenvolvimento no repositório para personalizar as ferramentas e os runtimes disponíveis para os alunos quando eles iniciarem um codespace para trabalhar na tarefa. Se você não definir um contêiner de desenvolvimento, o GitHub Codespaces usará uma configuração padrão, que contém muitas das ferramentas comuns que seus alunos podem precisar para desenvolvimento. Para obter mais informações sobre como definir um contêiner de desenvolvimento, confira Adicionando uma configuração de contêiner de desenvolvimento ao repositório.
Iniciando uma tarefa usando o GitHub Codespaces
Quando um aluno abre uma tarefa, o arquivo README do repositório inclui a recomendação do professor sobre o IDE que deve ser usado para o trabalho.
Os estudantes podem iniciar um codespace novo ou existente clicando no botão Open in GitHub Codespace no README ou clicando no botão Code na página principal do repositório da tarefa e selecionando a guia Codespaces. Na guia Codespaces, você pode selecionar um codespace existente ou criar um novo. Confira Como criar um codespace para um repositório.
Os professores podem visualizar o codespace de cada aluno para uma tarefa na página de visão geral do trabalho. Você pode clicar no ícone Codespaces no lado direito de cada linha de aluno para iniciar o Codespace.
Quando você se conecta a um codespace por meio de um navegador, o salvamento automático é habilitado automaticamente. Se você quiser salvar as alterações no repositório, precisará fazer commit das alterações e empurrá-las para um branch remoto. Se você deixar o codespace em execução sem interação por 30 minutos por padrão, o codespace atingirá o tempo limite e interromperá a execução. Seus dados serão preservados da última vez que você fez uma alteração. Para saber mais sobre o ciclo de vida de um codespace, confira Noções básicas sobre o ciclo de vida do codespace.