Como escolher quem tem a propriedade e paga pelos codespaces em sua organização

Visão geral

Se você for o proprietário de uma organização com um plano de GitHub Team ou GitHub Enterprise Cloud, poderá pagar pelo uso de GitHub Codespaces. Pagar pelo uso permitirá que as pessoas usem o GitHub Codespaces para trabalhar em seus repositórios sem ter que fazer isso por conta própria e dará à sua organização mais controle sobre os codespaces criados com base em seus repositórios.

Para pagar pelo uso, você deve seguir todas as etapas a seguir:

• Permita que pelo menos alguns de seus membros e colaboradores usem GitHub Codespaces nos repositórios privados e internos da sua organização. Confira "Habilitar ou desabilitar o GitHub Codespaces em sua organização".
• Escolha os codespaces criados nos repositórios da sua organização para serem de propriedade da organização. Confira “Como escolher quem possui e paga pelos codespaces”.
• Defina um limite de gastos diferente de zero para GitHub Codespaces. Confira "Gerenciar o limite de gastos do GitHub Codespaces".

Sobre como escolher quem paga pelos codespaces

Pagar por um codespace significa pagar pelos custos de armazenamento e computação do codespace durante a vida útil dele. Confira "Sobre o faturamento do GitHub Codespaces".

As organizações com um plano de GitHub Free não podem pagar pelo GitHub Codespaces, então o usuário que cria o codespace será quem pagará por ele.

Para organizações com um plano de GitHub Team ou GitHub Enterprise Cloud, quando um usuário cria um codespace com base em um repositório na organização, o usuário ou a organização pode pagar pelo codespace. O usuário que cria um codespace não pode escolher quem paga por ele, mas a organização pode escolher pagar por determinados usuários. Nas configurações da organização, você pode escolher que os codespaces sejam de propriedade do usuário ou de propriedade da organização.

Se uma organização escolher que os codespaces sejam de propriedade do usuário, se ele criar um codespace com base em um repositório na organização, sempre pagará pelo codespace. O acesso para criação de codespaces pelo usuário depende da visibilidade do repositório e das configurações de acesso de sua organização.

Se uma organização escolher que os codespaces sejam de propriedade da organização, ela pagará pelo codespace se todas as condições a seguir forem verdadeiras:

• A organização definiu um limite de gastos para GitHub Codespaces.
• O codespace é criado a partir de um dos repositórios da organização ou de um fork de um dos repositórios da organização. Isso inclui repositórios públicos, privados e internos.
• O usuário que cria o codespace é membro ou colaborador da organização, e a organização habilitou o GitHub Codespaces para ele. Isso poderá incluir todos os membros e colaboradores se a organização tiver optado por habilitar o Codespaces para todos os usuários. Se o Codespaces não estiver habilitado para um usuário, ele ainda poderá criar codespaces a partir de repositórios públicos na organização, mas o usuário pagará por esses codespaces.

Para obter mais informações sobre como habilitar GitHub Codespaces para membros e colaboradores, confira "Habilitar ou desabilitar o GitHub Codespaces em sua organização."

Sobre a propriedade de codespaces

A conta que possui o codespace é cobrada por ele. O proprietário do codespace pode ser o usuário que o criou ou uma organização.

Se sua organização possuir um codespace, ela terá controle sobre esse ele. Por exemplo, no caso de codespaces pertencentes à organização, você pode:

• Usar a API REST para gerenciamento, ou seja, para interromper ou excluir um codespace
• Acessar os logs de auditoria para revisar as ações relacionadas a GitHub Codespaces
• Definir políticas para gerenciar restrições, por exemplo, restringir a imagem de contêiner de desenvolvimento ou o tipo de máquina que pode ser usado em codespaces ou definir um tempo limite padrão e um período de retenção

Se o codespace for de propriedade do usuário, sua organização não terá nenhuma dessas opções de gerenciamento, mesmo que o codespace tenha sido criado com base em um dos repositórios da organização.

Quando um usuário criar um codespace, ele será informado de quem pagará por ele e, portanto, quem é o proprietário. Do ponto de vista de um usuário, além das políticas que sua organização pode usar para definir restrições em codespaces, a experiência com GitHub Codespaces será semelhante, independentemente de quem possui o codespace. Por exemplo, a maioria das configurações pessoais de um usuário para GitHub Codespaces, como dotfiles, segredos e verificação GPG, se aplicam independentemente de quem é o proprietário do codespace.

Sobre como alterar suas configurações

Quando você altera suas configurações de propriedade, os codespaces existentes podem ser transferidos para um novo proprietário.

Se você alterar da propriedade da organização para a propriedade do usuário, os codespaces atualmente pertencentes à sua organização serão transferidos para o usuário que criou o codespace. Antes de fazer essa alteração, você deverá solicitar a cada usuário que revise os codespaces que serão transferidos para sua propriedade. Esses codespaces agora serão usados na conta pessoal do usuário.

Se você alterar da propriedade do usuário para a propriedade da organização, os codespaces existentes poderão ser transferidos para a organização. Um codespace será transferido se o usuário que atualmente possui o codespace for um membro ou colaborador e se você tiver habilitado GitHub Codespaces para esse usuário. Caso contrário, o codespace permanecerá sob a propriedade do usuário.

Como escolher quem possui e paga pelos codespaces

1. No canto superior direito de GitHub, selecione sua foto de perfil e selecione Suas organizações.

2. Ao lado da organização, clique em Configurações.

3. Na barra leral esquerda, clique em Codespaces.

4. Em Codespaces, na barra lateral esquerda, clique em Geral.

5. Na página de configurações de Codespaces, em "Propriedade do codespace", selecione a configuração desejada para sua organização:

   • Propriedade da organização: os codespaces são de propriedade e pagos pela organização.
   • Propriedade do usuário: os codespaces são sempre de propriedade e pagos pelo usuário.

6. Opcionalmente, em "Acesso a codespaces", revise os membros e colaboradores para os quais você habilitou Codespaces. Esses são os únicos usuários que podem criar codespaces pelos quais sua organização paga. Confira "Habilitar ou desabilitar o GitHub Codespaces em sua organização".

Definindo um limite de gastos

Por padrão, todas as contas têm um limite de gastos de US$ 0 para GitHub Codespaces. Isso impede que novos codespaces sejam criados ou que os codespaces existentes sejam abertos, se isso incorrer em um custo faturável para sua conta pessoal, corporativa ou da organização. Para contas pessoais, se você tiver acesso para criar um codespace, poderá fazê-lo desde que a conta não tenha atingido o limite de seu uso mensal incluído. Para organizações e empresas, o limite de gastos padrão significa que, para permitir que as pessoas criem codespaces que são cobrados para a organização ou sua empresa-mãe, o limite precisa ser alterado para um valor acima de US$ 0.

Para obter informações sobre como gerenciar e alterar o limite de gastos da sua conta, confira "Gerenciar o limite de gastos do GitHub Codespaces".