Sobre os lançamentos
Versões são iterações de software implementáveis que você pode empacotar e disponibilizar para um público mais amplo para baixar e usar.
As versões são baseadas em tags do Git, que marcam um ponto específico no histórico do repositório. Uma data de tag pode ser diferente de uma data de versão, já que elas podem ser criadas em momentos diferentes. Para obter mais informações sobre como ver suas tags existentes, confira Visualizando releases e tags do seu repositório.
Você pode receber notificações quando novas versões são publicadas em um repositório sem receber notificações sobre outras atualizações para o repositório. Para saber mais, confira Visualizando suas assinaturas.
Qualquer pessoa com acesso de leitura a um repositório pode ver e comparar versões, mas somente pessoas com permissões de gravação a um repositório podem gerenciar versões. Para saber mais, confira Gerenciar versões em repositórios.
Você pode criar manualmente notas de versão enquanto gerencia uma liberação. Como alternativa, você pode gerar automaticamente notas de versão a partir de um modelo padrão, ou personalizar seu próprio modelo de notas de versão. Para saber mais, confira Notas de versão geradas automaticamente.
Ao exibir os detalhes de uma versão, a data de criação de cada ativo da versão será mostrada ao lado dele.
GitHub incluirá automaticamente links para baixar um arquivo zip e um tarball que contêm o conteúdo do repositório no momento da criação da tag.
Pessoas com permissões de administrador em um repositório podem escolher se os objetos do Git Large File Storage (Git LFS) estão incluídos nos arquivos ZIP e tarballs que o GitHub cria para cada versão. Para saber mais, confira Gerenciando objetos LFS do Git em arquivos do seu repositório.
Se uma versão consertar uma vulnerabilidade de segurança, você deverá publicar uma consultoria de segurança no seu repositório. GitHub revisa cada aviso de segurança publicado e pode usá-las para enviar Dependabot alerts para repositórios afetados. Para saber mais, confira Sobre os avisos de segurança do repositório.
Veja a guia Dependentes do grafo de dependência para saber quais repositórios e pacotes dependem do código no seu repositório e, que, portanto, podem ser afetados por uma nova versão. Para saber mais, confira Sobre o gráfico de dependências.
Você também pode usar a API de Releases para reunir informações, tais como o número de vezes que os usuários baixam um recurso de versão. Para saber mais, confira Pontos de extremidade da API REST para lançamentos e ativos de lançamento.
Cotas de armazenamento e banda
Até 1000 ativos de lançamento podem estar associados a uma só versão. Cada arquivo incluído em uma versão deve ser inferior a 2 GiB. Não há limite para o tamanho total de uma versão, nem uso de largura de banda.