Skip to main content

Usando o GitHub Codespaces com o GitHub Classroom

Você pode usar os GitHub Codespaces como o editor preferencial nas atribuições para dar aos alunos acesso a um ambiente do Visual Studio Code baseado em navegador com uma configuração de um clique.

Quem pode usar esse recurso?

Organization owners who are admins for a classroom can enable GitHub Codespaces for their organization and integrate GitHub Codespaces as the supported editor for an assignment. Para obter mais informações sobre administradores da classe, confira "Gerenciar salas de aula".

O GitHub Codespaces está disponível para uso com GitHub Classroom em organizações que usam o GitHub Team. Para descobrir se você se qualifica para uma atualização gratuita do GitHub Team, confira "Inscreva-se no GitHub Education como professor".

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 "Visão geral do GitHub Codespaces".

Depois que GitHub Codespaces estiver habilitado em uma organização ou empresa, os usuários poderão criar um codespace em qualquer branch ou commit em um repositório de uma organização ou empresa e começar a desenvolver usando recursos de computação baseados 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 de início rápido do 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 instalaçã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".

Note

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 obter mais informações, confira "Sobre o faturamento do GitHub Codespaces".

Note

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 verificados um subsídio mensal gratuito de GitHub Codespaces horas a serem usadas no GitHub Classroom. Estima-se que o subsídio gratuito seja suficiente para uma classe de 50 pessoas com 5 atribuições por mês, em um computador de 2 núcleos com 1 codespace armazenado por aluno.

Note

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 educacional do Codespaces, ao habilitar o GitHub Codespaces no GitHub Classroom para sua organização, o GitHub adicionará automaticamente uma política de Codespace para restringir os tipos de computadores de todos os codespaces da organização para computadores 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 versão versão prévia pública, se sua organização exceder o subsídio gratuito para uso do GitHub Codespaces, ela será cobrada pelo uso adicional. Confira "Sobre o faturamento do GitHub Codespaces".

Habilitando Codespaces para a sua organização

O GitHub Codespaces está disponível para uso com GitHub Classroom em organizações que usam 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

  1. Efetue o login em GitHub Classroom.
  2. No lado direito da página, clique em Nova sala de aula.
  3. 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".
  4. 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.
  5. 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

  1. Efetue o login em GitHub Classroom.

  2. Na lista de salas de aula, clique na sala de aula que você deseja visualizar.

  3. Abaixo do nome da sala de aula, clique em Configurações.

    Captura de tela das guias em uma sala de aula. A guia "Configurações" está contornada em laranja escuro.

  4. 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. Observe que isso desabilitará o GitHub Codespaces de todos os usuários e repositórios da organização.

Configurando uma tarefa 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 tarefa, na página "Adicionar seu código inicial e escolher seu IDE online opcional", em "Adicionar um editor com suporte", selecione o 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 alunos podem iniciar um codespace novo ou existente clicando no botão Abrir no GitHub Codespace no LEIAME ou clicando no botão Código na página principal do repositório de atribuições e selecionando a guia Codespaces. Na guia Codespaces, você pode selecionar um codespace existente ou criar outro. Confira "Como criar um codespace para um repositório".

Captura de tela do repositório de tarefas. O menu suspenso "Código" para iniciar um novo codespace é expandido.

Os professores podem exibir o codespace de uma tarefa de cada aluno na página de visão geral da tarefa. Você pode clicar no ícone Codespaces no lado direito de cada linha de aluno para iniciar o codespace.

Captura de tela da visão geral da tarefa. Há um ícone “Codespaces” com o contorno em laranja escuro.

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 efetuar push delas em 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".