O 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 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 Início Rápido do Codespaces.
Depois que 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 Codespaces, confira Início Rápido do 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 Codespaces, confira Aprofundamento de Codespaces.
Definir o Codespaces como o editor preferencial para uma tarefa do Classroom é benéfico para alunos e professores. O 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.
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 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 Pro. Para saber mais, confira Sobre o faturamento do Codespaces.
Observação
Se os alunos usarem Codespaces nos repositórios de atribuição do 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.
O benefício educacional do Codespaces oferece aos professores verificados um subsídio mensal gratuito de Codespaces horas a serem usadas no 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á 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 Education como professor.
Depois de confirmar que você é um professor verificado, visite o Education for Teachers para atualizar a organização para o Team. Consulte Produtos do .
Se você estiver qualificado para o benefício educacional do Codespaces, ao habilitar o Codespaces no Classroom para sua organização, o 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 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 Codespaces, ela será cobrada pelo uso adicional. Confira Sobre o faturamento do Codespaces.
O Codespaces está disponível para uso com Classroom em organizações que usam o Team. Se você estiver qualificado para o benefício educacional do Codespaces, deverá habilitar o Codespaces por meio do 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 Codespaces.
- Efetue o login em 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 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 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.
Efetue o login em Classroom.
Na lista de salas de aula, clique na sala de aula que você deseja visualizar.
Abaixo do nome da sala de aula, clique em Configurações.
Em " Codespaces", clique em Habilitar. Isso habilitará o 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 Codespaces em sua organização. Observe que isso desabilitará o Codespaces de todos os usuários e repositórios da organização.
Para disponibilizar o Codespaces aos alunos para uma tarefa, você pode escolher o 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 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 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.
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 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.
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.