Saltar para o conteúdo principal
Header

​
Diretrizes gerais

Always make sure to back up your database before starting the upgrade process by running docker exec -it {db_container_name_or_id} pg_dumpall -U {postgres_user} > databases_backup.sql. To restore backup, run cat databases_backup.sql | docker exec -i {db_container_name_or_id} psql -U {postgres_user}. Se você usou Docker Compose, siga estes passos:
  1. Em um terminal, no host onde Twenty está sendo executado, desligue o Twenty: docker compose down
  2. Atualize a versão alterando o valor TAG no arquivo .env próximo ao seu docker-compose. ( Recomendamos consumir a versão major.minor, como v0.53 )
  3. Reative o Twenty com docker compose up -d
Se você deseja atualizar sua instância por algumas versões, por exemplo, de v0.33.0 para v0.35.0, você deve atualizar sua instância sequencialmente, neste exemplo de v0.33.0 para v0.34.0, depois de v0.34.0 para v0.35.0. Certifique-se de que após cada versão atualizada você tenha um backup não corrompido.

​
Passos de atualização específicos da versão

​
v1.0

Olá Twenty v1.0! 🎉

​
v0.60

​
Melhorias de Desempenho

Todas as interações com a API de metadados foram otimizadas para melhor desempenho, particularmente para manipulação de metadados de objeto e operações de criação de espaço de trabalho. Refatoramos nossa estratégia de cache para priorizar acertos de cache sobre consultas de banco de dados sempre que possível, melhorando significativamente o desempenho das operações da API de metadados. Se você encontrar problemas de tempo de execução após a atualização, pode ser necessário limpar seu cache para garantir que esteja sincronizado com as alterações mais recentes. Execute este comando no seu contêiner do servidor Twenty: 
yarn command:prod cache:flush

​
v0.55

Atualize sua instância Twenty para usar a imagem v0.55 Você não precisa mais executar nenhum comando, a nova imagem cuidará automaticamente de executar todas as migrações necessárias.

​
Erro Usuário não tem permissão

Se você encontrar erros de autorização na maioria das solicitações após a atualização, pode ser necessário limpar seu cache para recalcular as permissões mais recentes. No seu contêiner twenty-server, execute: 
yarn command:prod cache:flush
Este problema é específico desta versão do Twenty e não deve ser necessário para futuras atualizações.

​
v0.54

Desde a versão 0.53, nenhuma ação manual é necessária.

​
Descontinuação do esquema de metadados

Mesclamos o esquema metadata no esquema core para simplificar a recuperação de dados do TypeORM. Mesclamos o passo do comando migrate dentro do comando upgrade. Não recomendamos executar migrate manualmente em nenhum de seus contêineres de servidor/trabalhadores.

​
Desde v0.53

A partir da versão 0.53, a atualização é realizada programaticamente dentro do DockerFile, o que significa que a partir de agora, você não precisará mais executar comandos manualmente. Certifique-se de continuar atualizando sua instância sequencialmente, sem pular nenhuma versão principal (por exemplo, 0.43.3 para 0.44.0 é permitido, mas 0.43.1 para 0.45.0 não é), caso contrário, pode levar a uma dessincronização da versão do espaço de trabalho que pode resultar em erro de tempo de execução e funcionalidade ausente. Para verificar se um espaço de trabalho foi migrado corretamente, você pode revisar sua versão no banco de dados na tabela core.workspace. Ela deve estar sempre no alcance da versão major.minor da sua instância atual do Twenty, você pode visualizar a versão da sua instância no painel de administração (em /settings/admin-panel, acessível se sua propriedade de usuário tiver canAccessFullAdminPanel definida como verdadeira no banco de dados) ou executando echo $APP_VERSION no seu contêiner twenty-server. Para corrigir uma versão de espaço de trabalho dessincronizada, você terá que atualizar a partir da versão correspondente do Twenty seguindo o guia de atualização relacionado sequencialmente e assim por diante até atingir a versão desejada.

​
auditLog removal

Removemos o objeto padrão auditLog, o que significa que o tamanho do backup pode ser significativamente reduzido após esta migração.

​
v0.51 para v0.52

Atualize sua instância Twenty para usar a imagem v0.52 
yarn database:migrate:prod
yarn command:prod upgrade

​
Eu tenho um espaço de trabalho bloqueado na versão entre 0.52.0 e 0.52.6

Infelizmente 0.52.0 e 0.52.6 foram completamente removidos do dockerHub. Você terá que atualizar manualmente a versão do seu espaço de trabalho para 0.51.0 no banco de dados e atualizar usando a versão twenty 0.52.11 seguindo seu guia de atualização logo acima.

​
v0.50 para v0.51

Atualize sua instância Twenty para usar a imagem v0.51 
yarn database:migrate:prod
yarn command:prod upgrade

​
v0.44.0 para v0.50.0

Atualize sua instância Twenty para usar a imagem v0.50.0 
yarn database:migrate:prod
yarn command:prod upgrade

​
Mutação do Docker-compose.yml

Esta versão inclui uma mutação docker-compose.yml para dar ao serviço worker acesso ao volume server-local-data. Por favor, atualize seu docker-compose.yml local com v0.50.0 docker-compose.yml

​
v0.43.0 para v0.44.0

Atualize sua instância Twenty para usar a imagem v0.44.0 
yarn database:migrate:prod
yarn command:prod upgrade

​
v0.42.0 para v0.43.0

Atualize sua instância Twenty para usar a imagem v0.43.0 
yarn database:migrate:prod
yarn command:prod upgrade
Nesta versão, também mudamos para a imagem postgres:16 no docker-compose.yml.

​
(Opção 1) Migração de Banco de Dados

Manter a imagem postgres-spilo existente está bem, mas você terá que congelar a versão no seu docker-compose.yml para ser 0.43.0.

​
(Opção 2) Migração de Banco de Dados

Se você deseja migrar seu banco de dados para a nova imagem postgres:16, siga estas etapas:
  1. Faça dump do seu banco de dados do contêiner antigo postgres-spilo
docker exec -it twenty-db-1 sh
pg_dump -U {YOUR_POSTGRES_USER} -d {YOUR_POSTGRES_DB} > databases_backup.sql
exit
docker cp twenty-db-1:/home/postgres/databases_backup.sql .
Certifique-se de que seu arquivo de backup não esteja vazio.
  1. Atualize seu docker-compose.yml para usar a imagem postgres:16 como no arquivo docker-compose.yml.
  2. Restaure o banco de dados para o novo contêiner postgres:16 
docker cp databases_backup.sql twenty-db-1:/databases_backup.sql
docker exec -it twenty-db-1 sh
psql -U {YOUR_POSTGRES_USER} -d {YOUR_POSTGRES_DB} -f databases_backup.sql
exit

​
v0.41.0 para v0.42.0

Atualize sua instância Twenty para usar a imagem v0.42.0 
yarn database:migrate:prod
yarn command:prod upgrade-0.42
Variáveis de Ambiente
  • Removido: FRONT_PORT, FRONT_PROTOCOL, FRONT_DOMAIN, PORT
  • Adicionado: FRONTEND_URL, NODE_PORT, MAX_NUMBER_OF_WORKSPACES_DELETED_PER_EXECUTION, MESSAGING_PROVIDER_MICROSOFT_ENABLED, CALENDAR_PROVIDER_MICROSOFT_ENABLED, IS_MICROSOFT_SYNC_ENABLED

​
v0.40.0 para v0.41.0

Atualize sua instância Twenty para usar a imagem v0.41.0 
yarn database:migrate:prod
yarn command:prod upgrade-0.41
Variáveis de Ambiente
  • Removido: AUTH_MICROSOFT_TENANT_ID

​
v0.35.0 para v0.40.0

Atualize sua instância Twenty para usar a imagem v0.40.0 
yarn database:migrate:prod
yarn command:prod upgrade-0.40
Variáveis de Ambiente
  • Adicionado: IS_EMAIL_VERIFICATION_REQUIRED, EMAIL_VERIFICATION_TOKEN_EXPIRES_IN, WORKFLOW_EXEC_THROTTLE_LIMIT, WORKFLOW_EXEC_THROTTLE_TTL

​
v0.34.0 para v0.35.0

Atualize sua instância Twenty para usar a imagem v0.35.0 
yarn database:migrate:prod
yarn command:prod upgrade-0.35
O comando yarn database:migrate:prod aplicará as migrações à estrutura do banco de dados (esquemas centrais e de metadados) O yarn command:prod upgrade-0.35 cuida da migração de dados de todos os espaços de trabalho. Variáveis de Ambiente
  • Substituímos ENABLE_DB_MIGRATIONS por DISABLE_DB_MIGRATIONS (o valor padrão agora é false, você provavelmente não precisa definir nada)

​
v0.33.0 para v0.34.0

Atualize sua instância Twenty para usar a imagem v0.34.0 
yarn database:migrate:prod
yarn command:prod upgrade-0.34
O comando yarn database:migrate:prod aplicará as migrações à estrutura do banco de dados (esquemas centrais e de metadados) O yarn command:prod upgrade-0.34 cuida da migração de dados de todos os espaços de trabalho. Variáveis de Ambiente
  • Removido: FRONT_BASE_URL
  • Adicionado: FRONT_DOMAIN, FRONT_PROTOCOL, FRONT_PORT
Atualizamos a maneira como lidamos com o URL do frontend. Agora você pode definir o URL do frontend usando as variáveis FRONT_DOMAIN, FRONT_PROTOCOL e FRONT_PORT. Se FRONT_DOMAIN não estiver definido, o URL do frontend será revertido para SERVER_URL.

​
v0.32.0 para v0.33.0

Atualize sua instância Twenty para usar a imagem v0.33.0 
yarn command:prod cache:flush
yarn database:migrate:prod
yarn command:prod upgrade-0.33
O comando yarn command:prod cache:flush irá limpar o cache do Redis. O comando yarn database:migrate:prod aplicará as migrações à estrutura do banco de dados (esquemas centrais e de metadados) O yarn command:prod upgrade-0.33 cuida da migração de dados de todos os espaços de trabalho. A partir desta versão, a imagem twenty-postgres para DB tornou-se obsoleta e twenty-postgres-spilo é usado em seu lugar. Se desejar continuar usando a imagem twenty-postgres, basta substituir twentycrm/twenty-postgres:${TAG} por twentycrm/twenty-postgres no docker-compose.yml.

​
v0.31.0 para v0.32.0

Atualize sua instância Twenty para usar a imagem v0.32.0 Migração de esquema e dados 
yarn database:migrate:prod
yarn command:prod upgrade-0.32
O comando yarn database:migrate:prod aplicará as migrações à estrutura do banco de dados (esquemas centrais e de metadados) O yarn command:prod upgrade-0.32 cuida da migração de dados de todos os espaços de trabalho. Variáveis de Ambiente Atualizamos a maneira como lidamos com a conexão Redis.
  • Removido: REDIS_HOST, REDIS_PORT, REDIS_USERNAME, REDIS_PASSWORD
  • Adicionado: REDIS_URL
Atualize o seu arquivo .env para usar a nova variável REDIS_URL em vez dos parâmetros individuais de conexão Redis. Também simplificamos a maneira como lidamos com os tokens JWT.
  • Removido: ACCESS_TOKEN_SECRET, LOGIN_TOKEN_SECRET, REFRESH_TOKEN_SECRET, FILE_TOKEN_SECRET
  • Adicionado: APP_SECRET
Atualize o seu arquivo .env para usar a nova variável APP_SECRET em vez dos segredos individuais de tokens (você pode usar o mesmo segredo de antes ou gerar uma nova string aleatória) Conta Conectada Se você estiver usando uma conta conectada para sincronizar seus e-mails e calendários do Google, será necessário ativar a People API no seu console do Google Admin.

​
v0.30.0 para v0.31.0

Atualize sua instância Twenty para usar a imagem v0.31.0 Migração de esquema e dados: 
yarn database:migrate:prod
yarn command:prod upgrade-0.31
O comando yarn database:migrate:prod aplicará as migrações à estrutura do banco de dados (esquemas centrais e de metadados) O yarn command:prod upgrade-0.31 cuida da migração de dados de todos os espaços de trabalho.

​
v0.24.0 para v0.30.0

Atualize sua instância Twenty para usar a imagem v0.30.0 Breaking change: To enhance performances, Twenty now requires redis cache to be configured. Atualizamos nosso docker-compose.yml para refletir isso. Certifique-se de atualizar sua configuração e de atualizar suas variáveis de ambiente de acordo: 
REDIS_HOST={your-redis-host}
REDIS_PORT={your-redis-port}
CACHE_STORAGE_TYPE=redis
Migração de esquema e dados: 
yarn database:migrate:prod
yarn command:prod upgrade-0.30
O comando yarn database:migrate:prod aplicará as migrações à estrutura do banco de dados (esquemas centrais e de metadados) O yarn command:prod upgrade-0.30 cuida da migração de dados de todos os espaços de trabalho.

​
v0.23.0 para v0.24.0

Atualize sua instância Twenty para usar a imagem v0.24.0 Execute os seguintes comandos: 
yarn database:migrate:prod
yarn command:prod upgrade-0.24
O comando yarn database:migrate:prod aplicará as migrações à estrutura do banco de dados (esquemas centrais e de metadados) O yarn command:prod upgrade-0.24 cuida da migração de dados de todos os espaços de trabalho.

​
v0.22.0 para v0.23.0

Atualize sua instância Twenty para usar a imagem v0.23.0 Execute os seguintes comandos: 
yarn database:migrate:prod
yarn command:prod upgrade-0.23
O comando yarn database:migrate:prod aplicará as migrações ao Banco de Dados. O yarn command:prod upgrade-0.23 cuida da migração de dados, incluindo transferir atividades para tarefas/notas.

​
v0.21.0 para v0.22.0

Atualize sua instância Twenty para usar a imagem v0.22.0 Execute os seguintes comandos: 
yarn database:migrate:prod
yarn command:prod workspace:sync-metadata -f
yarn command:prod upgrade-0.22
O comando yarn database:migrate:prod aplicará as migrações ao Banco de Dados. O comando yarn command:prod workspace:sync-metadata -f sincronizará a definição de objetos padrão com as tabelas de metadados e aplicará as migrações necessárias aos workspaces existentes. O comando yarn command:prod upgrade-0.22 aplicará transformações específicas de dados para adaptar-se às novas object defaultRequestInstrumentationOptions.