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.

Who can use this feature

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 os administradores de sala de aula, confira "Sobre o gerenciamento de salas de aula".

GitHub Codespaces is available to use with GitHub Classroom for organizations that use GitHub Team. To find out if you qualify for a free upgrade to GitHub Team, see "Apply to GitHub Global Campus as a teacher."

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. Para obter mais informações, 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 se conectar a um codespace por meio do navegador ou localmente usando o Visual Studio Code.

Para começar a usar os GitHub Codespaces, confira "Guia de início rápido dos 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 como os GitHub Codespaces funcionam, confira "Aprofundamento nos 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 obter mais informações sobre contêineres de desenvolvimento, confira "Introdução aos contêineres de desenvolvimento".

Observação: os codespaces individuais serão excluídos automaticamente se forem parados e deixados sem uso por um período prolongado. Para obter mais informações, confira "Como configurar a exclusão automática de 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 a 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 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.

Observação: o benefício do Codespaces para Educação está atualmente em versão beta pública e está sujeito a alterações. Durante o uso da versão beta, 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. Para obter mais informações, confira "Candidatar-se para o GitHub Global Campus como professor."

Depois de confirmar que você é um professor verificado, visite o GitHub Global Campus for Teachers para atualizar a organização para o GitHub Team. Para obter mais informações, confira 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. Para obter mais informações, confira "Como restringir o acesso aos tipos de computadores".

Quando o Benefício educacional do Codespaces sair da versão beta, se sua organização exceder o subsídio gratuito para uso do GitHub Codespaces, ela será cobrada pelo uso adicional. Para obter mais informações, confira "Sobre a cobrança 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. Clique em Nova sala de aula.

    Botão "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. Para obter mais informações, confira "Como criar uma organização do zero".

    Escolher a organização para a sala de aula com qualificação para o codespaces

  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.

    Habilitar Codespaces para a organização na página "Configurar noções básicas da sala de aula"

  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. 1. Na lista de salas de aula, clique na sala de aula que você deseja visualizar. Sala de aula na lista de salas de aula de uma organização 1. No nome da sala de aula, clique em Configurações. Guia "Configurações" da sala de aula

  2. 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.

    Habilitar Codespaces para a organização em configurações de sala de aula existentes

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.

Selecione Codespaces como editor com suporte para a tarefa

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, veja "Adicionar uma configuração de contêiner de desenvolvimento ao seu 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.

Captura de tela da observação do Codespaces no README para um repositório de tarefa para aluno

Os alunos podem iniciar um codespace novo ou existente clicando no botão Abrir no Codespace do GitHub no README ou clicando no botão Código na página principal do repositório de tarefas e selecionando a guia Codespaces. Na guia Codespaces, você pode selecionar um codespace existente ou criar um. Para obter mais informações, confira "Como criar um codespace para um repositório".

Iniciar codespace novo no repositório de tarefa

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.

Visão geral da tarefa para o professor com os codespaces do aluno

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 obter mais informações sobre o ciclo de vida de um codespace, confira "O ciclo de vida do codespace".