Sobre o GitHub Codespaces
GitHub Codespaces é um ambiente de desenvolvimento instantâneo baseado em nuvem que usa um contêiner para fornecer linguagens, ferramentas e utilitários comuns para desenvolvimento. GitHub Codespaces também é configurável, permitindo que você crie um ambiente de desenvolvimento personalizado que seja o mesmo para todos os usuários do seu projeto. Confira Guia Rápido para GitHub Codespaces.
Assim que o GitHub Codespaces estiver habilitado em uma organização ou empresa, os usuários poderão criar um espaço de código a partir de qualquer branch ou commit em um repositório da organização ou empresa e começar a desenvolver usando recursos de computação baseados em nuvem. Você pode se conectar a um codespace do navegador ou localmente usando 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 GitHub Codespaces como o editor preferencial para uma tarefa em GitHub tarefas de Sala de Aula é benéfico para alunos e professores. GitHub Codespaces é uma boa opção para alunos 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 espaço de código para um repositório de tarefas no Visual Studio Code diretamente em seu navegador e começar a desenvolver imediatamente, sem precisar de nenhuma configuração adicional.
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.
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 obtêm uso gratuito de GitHub Codespaces, até 180 horas principais por mês, para suas contas pessoais. A quantidade mensal de armazenamento e horas principais de uso disponíveis para os alunos é equivalente ao valor incluído nas GitHub Pro contas. 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 Codespaces educacional para professores verificados
O benefício Codespaces para Educação oferece aos professores verificados uma cota mensal gratuita 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 prévia pública e está sujeito a alterações. Durante o uso do 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.
Após a confirmação de que você é um professor verificado, visite GitHub Education para Professores para atualizar a organização para Equipe do GitHub. Consulte Produtos do GitHub.
Se você for elegível para o benefício Codespaces para Educação, ao habilitar o GitHub Codespaces no GitHub Classroom para sua organização, o GitHub adicionará automaticamente uma política de Espaço de Código para restringir os tipos de máquina para todos os espaços de código na organização a máquinas com 2 núcleos. Isso ajuda você a aproveitar ao máximo o uso gratuito 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 Codespaces para Educação deixar de estar disponível no prévia pública, se sua organização exceder a cota gratuita de uso do GitHub Codespaces, sua organização será cobrada pelo uso adicional. Confira Cobrança do GitHub Codespaces.
Habilitando Codespaces para sua organização
GitHub Codespaces está disponível para uso com GitHub Classroom para organizações que utilizam GitHub Team. Se você for elegível para o benefício educacional Codespaces, você deve habilitar GitHub Codespaces por meio de 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 de 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 elegíveis para GitHub Codespaces terão uma observação informando que são elegíveis. Opcionalmente, você pode criar uma nova organização. Confira Criar uma organização do início.
- Na página "Nomeie sua sala de aula", em "Codespaces na sala de aula", clique em Habilitar. Observe que isso habilitará 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á 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 GitHub Codespaces para sua organização. Observe que isso desabilitará GitHub Codespaces para todos os usuários e repositórios da organização.
Configurar uma tarefa para usar Codespaces
Para disponibilizar GitHub Codespaces para os alunos em uma tarefa, você pode escolher GitHub Codespaces como o editor compatível para a tarefa. Ao criar uma nova tarefa, na página "Adicione seu código inicial e escolha seu IDE online opcional", em "Adicionar um editor compatível", 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, 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 atribuição usando 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 README ou clicando no botão Código na página principal do repositório de atribuição e selecionando a guia Codespaces. Na guia Codespaces, você pode selecionar um codespace existente ou criar um. Confira Como criar um codespace para um repositório.
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.
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.