Dimensionando a migração do ScriptRunner para o Cloud antes de fechar uma data
O ScriptRunner costuma ser o app mais difícil de uma migração do Jira, e as estimativas dele erram para os dois lados. Como montar uma matriz de todos os scripts, tirar o que está morto, juntar os duplicados, traduzir um primeiro rascunho para ver a dificuldade real e apresentar dois números honestos.
O ScriptRunner no Cloud tem o mesmo nome do ScriptRunner no Data Center. Não é o mesmo produto, e estimativas que esquecem isso erram para os dois lados.
Na maioria dos sites Jira Data Center que avaliamos, o ScriptRunner é o app que decide o esforço da migração. Normalmente está lá há anos, mexe em workflows, campos, listeners e jobs agendados, e boa parte do que ele faz foi escrita por pessoas que já não estão por perto para explicar.
As estimativas que vemos para ele falham de dois jeitos opostos. “Mais ou menos um dia por script” soa prudente e produz um número tão grande que a migração é adiada. “O ScriptRunner tem versão Cloud, então migra” soa tranquilizador e produz um fim de semana de virada cheio de transições quebradas. As duas vêm de pular o mesmo trabalho.
Por que o Cloud é outro produto
No Data Center, um script roda dentro do Jira, com acesso direto à API Java interna do Jira e ao banco de dados. No Cloud, o ScriptRunner roda fora do Jira e conversa com ele pela API REST pública, como qualquer outra integração.
Essa única diferença explica a maioria das surpresas. Código que chamava classes internas precisa ser reescrito contra endpoints REST. Alguns eventos que um listener do Data Center conseguia interceptar no momento em que aconteciam chegam no Cloud depois do fato, então um script que antes impedia algo agora precisa reagir a ele. Comportamentos de campos nas telas funcionam dentro de limites mais estreitos. Nada disso é defeito; é o que significa rodar fora do produto. Mas torna falso o “migra” para a maioria dos scripts customizados.
Uma linha por script
A estimativa começa com uma matriz: uma linha para cada item do ScriptRunner, seja de que tipo for. Cada linha registra o tipo do item, os spaces que ele afeta, quando rodou pela última vez, se está desativado, uma decisão, um destino no Cloud e como verificar que a versão Cloud funciona.
Parece pesado para um exercício de dimensionamento. É o único formato que conhecemos que permite entregar o trabalho para desenvolvedores depois, refazer as contas quando o escopo muda e responder “por que isso está na estimativa?” para qualquer linha.
Quatro decisões, não duas
Cada linha recebe uma de quatro decisões:
- Reimplementar no ScriptRunner para Cloud. O padrão para tudo o que ainda é necessário.
- Substituir por Jira Automation. Regras simples que disparam num evento e preenchem um campo muitas vezes pertencem a ela hoje, e são mais fáceis de manter.
- Substituir por outro app ou por um pequeno app em Forge. Quando o trabalho fica melhor em outro lugar.
- Retirar. Quando nada precisa ser feito.
Nos inventários de Jira que dimensionamos, a reimplementação costuma ser a maioria, a Automation fica com uma fatia relevante, e as retiradas nunca são irrelevantes.
Retire primeiro, estime depois
Antes de estimar qualquer coisa, tire o que não precisa migrar: itens desativados, itens que nunca rodaram, itens cuja última execução foi há muitos meses, itens que só afetam spaces arquivados ou mortos, e itens ligados a workflows de teste. Cada um deles é uma linha que alguém teria estimado, construído e testado para nada.
Junte os duplicados
Acervos grandes de ScriptRunner estão cheios de copiar e colar. O mesmo validador vive em quarenta workflows com uma chave de space diferente em cada um. Normalize os espaços em branco, gere um hash de cada script e agrupe os idênticos. Nos acervos que medimos, cerca de um quarto das funções de workflow se reduziu a um conjunto bem menor de fragmentos compartilhados. Estimar cada cópia separadamente é como um dimensionamento dobra.
Traduza um primeiro rascunho para ver a dificuldade real
O jeito mais rápido de saber quão difícil é migrar um script é começar a migrá-lo. Uma tradução de primeiro rascunho de cada script restante, feita para dimensionar e não para entregar, mostra exatamente onde está a dificuldade: chamadas a APIs internas sem equivalente REST, lógica que supunha rodar antes de uma mudança e não depois, e dados que precisam ser convertidos antes da virada. Um script que parece assustador muitas vezes se traduz em minutos; um de dez linhas às vezes não tem equivalente nenhum no Cloud.
Apresente dois números, lado a lado
Damos dois totais. Uma base que supõe que cada item é reconstruído individualmente, e um total assistido que reflete padrões construídos uma vez e reutilizados, duplicados juntados e recursos do Cloud fazendo parte do trabalho. Depois explicamos a diferença linha por linha.
Dois números com os seus motivos se sustentam numa reunião de orçamento muito melhor do que um. Quando alguém pergunta por que o número assistido é menor, a resposta está na matriz, e não na nossa confiança.
Em resumo
O ScriptRunner no Cloud roda fora do Jira, então a maioria dos scripts customizados precisa ser reescrita, e não apenas migrada. Monte uma matriz com uma linha por item, escolha entre reimplementar, Automation, outro app ou retirar, tire os itens mortos antes de estimar, junte os duplicados, traduza um primeiro rascunho para achar a dificuldade real, e apresente um número base e um assistido com a diferença explicada. É o dimensionamento que o nosso time Atlassian faz antes de alguém se comprometer com uma data.
Planejando uma migração, ou arrumando a casa depois de uma?
Avaliamos migrações do Data Center para o Cloud, dimensionamos a reescrita do ScriptRunner, tiramos equipes de outras ferramentas e limpamos o que a migração deixa para trás. Você fala com quem faz o trabalho.
Compartilhar
Leitura relacionada
Depois da migração para o Cloud: limpando o que a mudança deixou para trás
A virada correu bem. Aí os administradores encontram (migrated) por toda parte: esquemas, papéis e telas duplicados, e notas debaixo de cada campo. Por que os duplicados existem, como consolidá-los com segurança e como impedir que o site novo volte a ficar parecido com o antigo.
Saindo do Smartsheet para o Jira e o Confluence: o que vai para onde
Levar tudo para o Jira é o plano errado. Um acervo do Smartsheet são muitos tipos de coisa vestindo a mesma grade. Como separar as planilhas pelo que elas realmente são, migrar só as vivas, usar templates em vez de casos isolados, e lidar com as fórmulas, automações e formulários que nunca migram sozinhos.
Encontrando as licenças Atlassian que você paga e ninguém usa
O Atlassian Cloud cobra por toda conta com acesso ao produto, tenha a pessoa entrado este ano ou não, e os seus apps do Marketplace seguem a mesma contagem de usuários. Como encontrar as contas inativas, separá-las antes de remover alguém e tornar a recuperação de licenças um hábito, e não um projeto anual.