Rollouts

Um rollout é um lote nomeado de versões de registros com um único horário agendado. Nesse momento ele publica a versão indicada de cada registro, de modo que uma campanha espalhada por muitos registros entra no ar junta.

O que um rollout contém

Um rollout tem um nome, um horário agendado e uma lista de versões de registros. O horário é obrigatório, e enquanto o rollout ainda está agendado você pode editar seu nome, descrição, horário e itens.

Ele carrega apenas versões de registros. Mudanças em modelos e na configuração seguem em uma release, e um rollout pode indicar uma release agendada para sair primeiro. A release então é lançada no momento do rollout, antes do conteúdo. Se ela for recusada ou falhar, o rollout é marcado como com falha, com o motivo, e nenhum de seus conteúdos é publicado.

O que acontece quando um item falha

Todos os itens rodam em uma única transação de banco de dados, cada um sob seu próprio savepoint. Um item que falha é revertido sozinho e registrado como falho. Os outros ainda são publicados, e se tornam visíveis juntos quando a transação é confirmada. Depois, o rollout aparece como Concluído se todos os itens tiveram sucesso, Parcial se alguns falharam e Falhou se todos falharam.

Os controles

Um rollout agendado pode ser disparado antes da hora, pausado e retomado, e pode ser excluído até ser disparado. Tentar de novo executa novamente apenas os itens que falharam. Reverter republica a versão anteriormente publicada de cada item. Você pode visualizar uma reversão antes de executá-la, e a prévia aponta qualquer item que não tenha versão publicada anterior.

Onde você os gerencia

Os rollouts são gerenciados no console em Conteúdo, Agendados, Rollouts, pela CLI com foir rollouts, e por ferramentas de agente. A API GraphQL pública não os gerencia. Para o CI, o padrão documentado é um job agendado que cria o rollout a partir de um arquivo com a CLI. Criar um exige a schedules:write permissão.

Leia os detalhes

O guia de publicação agendada cobre a criação de um rollout, seus status e cada controle do ciclo de vida.