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

Você pode escolher se os codespaces são pagos e de propriedade de sua organização ou de seus membros.

Quem pode usar esse recurso?

Organization owners can change an organization's billing details and control who owns and pays for codespaces.

Organizations on GitHub Team and GitHub Enterprise plans can pay for their members' use of GitHub Codespaces. These organizations can then access policies that apply to codespaces paid for by the organization. See "Planos do GitHub."

Neste artigo

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:

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 tanto públicos quanto privados.
  • 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

Note

Se você não consegue acessar a opção de tornar os codespaces de propriedade da organização, talvez tenha desabilitado GitHub Codespaces para todos os usuários nos repositórios privados de sua organização. Confira “Como escolher quem 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

Note

Você precisa definir um limite de gastos diferente de zero na sua conta pessoal, organizacional ou empresarial para que a conta possa ser cobrada pelo uso do GitHub Codespaces.

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