Migre da Cloudflare para a Azion

Uma migração de plataforma geralmente começa muito antes de o primeiro arquivo de configuração ser alterado. Começa quando uma equipe percebe que seu ambiente atual não oferece mais o mesmo nível de clareza, velocidade ou controle que antes.

Talvez os deployments ainda funcionem, mas o processo requer muita coordenação manual. Talvez a aplicação tenha crescido além da arquitetura original. Talvez a equipe precise de maior conformidade, comportamento de runtime mais previsível, ou uma forma mais unificada de gerenciar compute, storage, bancos de dados, entrega e segurança.

Para equipes que utilizam Cloudflare Pages, Workers, Workers KV, R2, D1, redirecionamentos, headers customizados, DNS, WAF, logs ou analytics, a Azion oferece recursos equivalentes através de Applications, Functions, KV Store, Object Storage, SQL Database, Rules Engine, Edge DNS, Web Application Firewall, Real-Time Events e Real-Time Metrics.

O motivo mais forte para migrar não é simplesmente substituir um fornecedor por outro. É modernizar sua plataforma de aplicações sem reiniciar sua arquitetura do zero.

Como Funciona a Migração da Cloudflare para a Azion

Migrações de plataforma tradicionais frequentemente exigem reescrever a lógica da aplicação, reconfigurar a infraestrutura do zero e gerenciar múltiplos serviços desconectados. Essa abordagem cria risco operacional, estende prazos e fragmenta o conhecimento da equipe entre diferentes padrões de configuração.

A abordagem de migração da Azion preserva a lógica da sua aplicação enquanto faz a transição para uma plataforma unificada:

1. Caminho de migração incremental. Comece com um único projeto, valide cada camada independentemente e expanda com confiança. Não é necessário migrar tudo de uma vez.

2. Lógica de aplicação preservada. Functions, redirecionamentos, headers e serviços de dados mapeiam diretamente para equivalentes na Azion com mudanças mínimas de código — principalmente atualizações de sintaxe para acesso a ambiente e imports de serviços.

3. Modelo de plataforma unificado. Em vez de gerenciar compute, storage, bancos de dados, segurança e observabilidade como camadas desconectadas, a Azion reúne esses recursos com APIs consistentes e padrões de configuração.

Mapeamento de Recursos

A tabela a seguir fornece um mapeamento abrangente dos produtos Cloudflare para seus equivalentes na Azion. Um traço (-) indica que a Azion atualmente não oferece um equivalente direto.

¹ Orchestrator inclui Edge Services e Edge Node como módulos integrados para orquestrar workloads em containerizados em infraestrutura de edge privada.

² Functions podem ser instanciadas dentro do Firewall para transformar requisições e respostas no edge.

Estratégia de Migração

A migração é organizada em torno das quatro categorias de produtos da Azion, permitindo que as equipes planejem e executem cada camada independentemente:

• Build: faça deploy de aplicações, configure builds e variáveis de ambiente, migre Functions, roteamento, headers, load balancing, cache, otimização de imagens e workloads de IA.
• Secure: migre domínios customizados, DNS, certificados SSL/TLS, WAF, proteção DDoS, gerenciamento de bots e rate limiting.
• Store: migre dados key-value, object storage e bancos de dados SQL.
• Observe: migre analytics, métricas e logs para a stack de observabilidade em tempo real da Azion.

Build

A categoria Build cobre deployment de aplicações, compute, roteamento e configuração. Comece aqui para trazer sua aplicação para a Azion e estabelecer a fundação para o resto da migração.

1. Configuração do Projeto na Azion

O primeiro passo traz sua aplicação para a Azion de uma forma que parece familiar para equipes que deployam projetos web modernos. Se você usou Cloudflare Pages, já entende o padrão: conectar um repositório, definir configurações de framework, executar um build, fazer deploy do output e validar a URL gerada.

A Azion segue um fluxo similar mas com um contexto de plataforma mais amplo. Seu projeto se torna parte de um ambiente onde entrega de aplicações, Functions, regras, segurança e observabilidade podem ser gerenciados juntos.

Diferenças Principais

Conecte Seu Repositório

1. Abra o Azion Console.
2. Clique em + Create > Import from GitHub.
3. Autorize o GitHub App da Azion.
4. Selecione o repositório que deseja migrar.

Configure Seu Build

A Azion detecta automaticamente seu framework e configura as definições de build. Sobrescreva o preset detectado em azion.config.js:

import { defineConfig } from 'azion'

export default defineConfig({
name: 'my-project',
preset: 'nextjs', // Sobrescreva a auto-detecção se necessário
})

Faça Deploy e Verifique

Faça deploy pelo Azion Console ou CLI. Sua URL temporária da Azion segue este padrão:

https://xxxxxxxxxx.map.azionedge.net/

Valide o deployment:

curl https://xxxxxxxxxx.map.azionedge.net/

Documentação de referência

• Applications
• Applications primeiros passos
• Azion CLI visão geral
• Importe um projeto existente do GitHub

2. Convertendo Configuração de Build

Uma migração pode parecer bem-sucedida quando o build passa mas falhar depois quando o comportamento de runtime difere. Revise cuidadosamente a configuração de build e deployment em vez de tratá-la como uma substituição mecânica de comandos.

Referência Rápida de CLI

Documentação de referência

• Azion CLI visão geral
• azion.config.js referência
• azion deploy comando

3. Migrando Variáveis de Ambiente

Variáveis de ambiente contêm API keys, credenciais de banco de dados, secrets de autenticação, endpoints de serviços, feature flags e configuração específica de ambiente. Migrá-las incorretamente causa falhas de runtime mesmo quando o deployment é bem-sucedido.

Diferenças Principais

Avalie Suas Variáveis

Antes de mudar o código, identifique todas as variáveis em:

• Cloudflare Pages: Dashboard > Settings > Environment variables
• Cloudflare Workers: wrangler.toml
• Secrets gerenciados via CLI
• Configurações de ambiente CI/CD
• Configuração de runtime no código fonte

Crie Variáveis na Azion

curl -X POST 'https://api.azionapi.net/variables' --header 'Accept: application/json; version=3' --header 'Authorization: Token [TOKEN VALUE]' --header 'Content-Type: application/json' --data '{
"key": "key-test",
"value": "value-test"
}'

Atualize Seu Código

// Antes: Cloudflare
const apiKey = env.API_KEY;

// Depois: Azion
const apiKey = Azion.env.get('API_KEY');

Documentação de referência

• Variáveis de Ambiente
• Trabalhando com variáveis
• Azion referência de variáveis de ambiente de runtime

4. Migrando URLs de Rewrite e Redirect

Redirecionamentos protegem anos de valor de SEO, links de campanha, backlinks, favoritos e expectativas de usuários. Quando redirecionamentos quebram, o impacto aparece como tráfego perdido, rankings menores e experiência de usuário ruim.

Diferenças Principais

Conversão de Padrões

Crie Regras de Redirect

Navegue para Rules Engine e configure:

Critérios:

${uri} matches ^/old-blog/(.*)$

Comportamento:

Redirect To (301): /blog/%{capture[1]}

Verifique Redirecionamentos

curl -I https://seudominio.com/old-blog/post

Documentação de referência

• Rules Engine para Applications
• Rules Engine variáveis e operadores
• Applications referência

5. Migrando Headers Customizados

Headers HTTP controlam cache, segurança e comportamento do browser. A Azion oferece às equipes um modelo mais flexível através do azion.config.js e Rules Engine, permitindo regras que respondem a características da requisição.

Diferenças Principais

Exemplo: Headers de Segurança

import type { AzionConfig } from 'azion/config';

const config: AzionConfig = {
applications: [{
  name: 'my-app',
  rules: {
    response: [{
      name: 'Security Headers',
      active: true,
      criteria: [{
        variable: 'uri',
        conditional: 'if',
        operator: 'starts_with',
        argument: '/'
      }],
      behavior: {
        addResponseHeader: [
          'X-Frame-Options: SAMEORIGIN',
          'X-Content-Type-Options: nosniff'
        ]
      }
    }]
  }
}]
};

export default config;

Documentação de referência

• Rules Engine para Applications
• azion.config.js referência
• Applications configurações principais

6. Migrando Workers para Functions

Functions são o motor computacional de aplicações distribuídas modernas. Frequentemente contêm a lógica mais crítica do negócio: autenticação, personalização, orquestração de API e integrações com sistemas de terceiros.

Diferenças Principais

Atualize Assinatura da Função

// Antes: Cloudflare
export default {
async fetch(request, env, ctx) {
  const apiKey = env.API_KEY;
  return fetch(apiUrl, { headers: { 'Authorization': `Bearer ${apiKey}` }});
}
};

// Depois: Azion
export default {
async fetch(request, env, ctx) {
  const apiKey = Azion.env.get('API_KEY');
  return fetch(apiUrl, { headers: { 'Authorization': `Bearer ${apiKey}` }});
}
};

Atualize Metadados Geo

// Antes: Cloudflare
const country = request.cf.country;

// Depois: Azion
const country = request.metadata['geoip_country_code'];

Atualize Imports de Serviços

A Azion fornece duas interfaces SQL:

• Runtime API (azion:sql) — para consultar bancos de dados a partir de Functions
• Azion Lib SDK (azion/sql) — para gerenciar bancos de dados via API (ferramentas de build, scripts)

import { Database } from 'azion:sql';

// Abre conexão (async)
const db = await Database.open('my-database');

// Consulta e itera resultados
const rows = await db.query('SELECT * FROM users');
let row = await rows.next();
while (row) {
const name = row.getString(0); // acessa coluna por índice
console.log(name);
row = await rows.next();
}

Documentação de referência

• Functions
• Functions Instances
• Runtime APIs
• JavaScript Runtime APIs referência
• SQL Database API (Runtime)
• Azion Lib SQL (SDK)

7. Migrando Load Balancing

Load balancing distribui tráfego entre múltiplas origens para alta disponibilidade e performance. O Azion Load Balancer fornece health checks, políticas de steering e failover de origem.

Diferenças Principais

Passos de Configuração

# Crie um Connector (origem) com load balancing configurado no nível de endereço
curl -X POST 'https://api.azionapi.net/v4/workspace/connectors' --header 'Authorization: Token YOUR_TOKEN' --header 'Content-Type: application/json' --data '{
  "name": "Origin-US-East",
  "type": "http",
  "attributes": {
    "addresses": [
      {
        "address": "origin1.example.com",
        "active": true,
        "modules": {
          "load_balancer": {
            "weight": 3
          }
        }
      },
      {
        "address": "origin2.example.com",
        "active": true,
        "modules": {
          "load_balancer": {
            "weight": 1
          }
        }
      }
    ]
  }
}'

Configuração do Módulo Load Balancer

// Configurações de load balancer dentro dos módulos de endereço
{
"weight": 3,                    // Peso relativo para distribuição ponderada
"method": "round_robin",        // Opções: "round_robin", "least_conn", "ip_hash"
"max_retries": 3,               // Máximo de tentativas de retry
"connection_timeout": 10,       // Timeout de conexão em segundos
"read_write_timeout": 30        // Timeout de leitura/escrita em segundos
}

Documentação de referência

• Load Balancer
• Connectors

8. Migrando Configuração de Cache

A configuração de cache determina como o conteúdo é armazenado e servido a partir de localizações distribuídas. O Azion Cache fornece controle granular sobre o comportamento do cache com suporte a Tiered Cache.

Diferenças Principais

Migração de Configurações de Cache

# Atualize configurações de cache para uma configuração específica dentro de uma aplicação
curl -X PATCH 'https://api.azion.com/v4/workspace/applications/{application_id}/cache_settings/{cache_setting_id}' --header 'Authorization: Token YOUR_TOKEN' --header 'Content-Type: application/json' --data '{
  "name": "my-cache-setting",
  "browser_cache": {
    "ttl": 3600
  },
  "modules": {
    "cache": {
      "ttl": 86400
    },
    "tiered_cache": {
      "enabled": true
    }
  }
}'

Tiered Cache

Habilite Tiered Cache para melhorar o cache hit ratio:

// Tiered cache é configurado dentro dos módulos de cache settings
{
"name": "my-cache-setting",
"modules": {
  "tiered_cache": {
    "enabled": true
  }
}
}

Customização de Cache Key

A customização de cache key usa Advanced Cache Key nas Cache Settings combinado com Adaptive Delivery para variações baseadas em dispositivo:

Exemplo: Variar cache por grupo de dispositivo

1. Em Cache Settings, habilite Adaptive Delivery
2. Selecione “Content varies by some Device Groups (Whitelist)“
3. Escolha grupos de dispositivo (ex: Mobile, Desktop)
4. Aplique via Rules Engine:

Critérios: ${uri} starts with /images/
Comportamento: Set Cache Policy → [nome-cache-setting]

Cache Purge

# Purge por URL
curl -X POST 'https://api.azion.com/v4/workspace/purge/url' --header 'Authorization: Token YOUR_TOKEN' --header 'Content-Type: application/json' --data '{
  "items": [
    "https://example.com/image.jpg",
    "https://example.com/styles.css"
  ],
  "layer": "cache"
}'

# Purge por wildcard
curl -X POST 'https://api.azion.com/v4/workspace/purge/wildcard' --header 'Authorization: Token YOUR_TOKEN' --header 'Content-Type: application/json' --data '{
  "items": ["https://example.com/images/*"],
  "layer": "cache"
}'

Documentação de referência

• Cache
• Cache Settings
• Tiered Cache
• Real-Time Purge
• Application Accelerator

9. Migrando Otimização de Imagens

A otimização de imagens reduz tamanhos de arquivos de imagem mantendo a qualidade visual. O Azion Image Processor transforma, otimiza e entrega imagens a partir de localizações de nós distribuídos.

Diferenças Principais

Passos de Configuração

# Habilite Image Processor dentro dos módulos da aplicação
curl -X PATCH 'https://api.azionapi.net/v4/workspace/applications/{application_id}' --header 'Authorization: Token YOUR_TOKEN' --header 'Content-Type: application/json' --data '{
  "modules": {
    "image_processor": {
      "enabled": true
    }
  }
}'

Formato de URL

Transforme imagens via parâmetros de query string:

# Formato Cloudflare
https://example.com/cdn-cgi/image/width=400,quality=85/image.jpg

# Formato Azion
https://example.com/image.jpg?ims=400x400

Parâmetros de Transformação

O Azion Image Processor usa o parâmetro de query ims para transformações:

Documentação de referência

• Image Processor
• Como processar imagens
• Object Storage

10. Migrando Workloads de IA (Workers AI para AI Inference)

Inferência de IA habilita recursos alimentados por IA com baixa latência em aplicações. O Azion AI Inference fornece inferência com suporte a GPU para modelos de texto e visuais, permitindo executar workloads de IA próximos aos seus usuários.

Diferenças Principais

Usando AI Inference

// Inferência de IA em Functions
export default {
async fetch(request) {
  const response = await fetch('https://ai-inference.example.com/v1/predict', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${Azion.env.get('AI_API_KEY')}`
    },
    body: JSON.stringify({
      model: 'text-generation',
      prompt: await request.text()
    })
  });
  return response;
}
};

AI Starter Kit

Use o template AI Inference Starter Kit:

# Deploy via CLI
azion deploy --template ai-inference-starter-kit

Documentação de referência

• AI Inference
• AI Inference modelos
• AI Inference Starter Kit

Secure

A categoria Secure cobre domínios, DNS, certificados, regras de firewall e proteção contra tráfego malicioso. Planeje essas migrações como cutovers controlados, já que afetam como os usuários acessam sua aplicação e como ela é protegida em produção.

1. Migrando Domínios Customizados

A migração de domínios customizados é uma das partes mais sensíveis de qualquer transição de plataforma. Afeta usuários, SEO, confiança na marca e disponibilidade de produção. Planeje a migração de domínio como um cutover controlado, não uma mudança de DNS de última hora.

Estratégias de Migração

Crie o Certificado

Crie seu certificado SSL/TLS antes de apontar seu domínio para a Azion. Isso garante que os usuários possam acessar a aplicação de forma segura via HTTPS quando o domínio começar a resolver para a nova infraestrutura.

A Azion fornece certificados Let’s Encrypt gratuitos com renovação automática.

Configure o Domínio

Crie um workload no Azion Console e associe seu domínio customizado. Veja Documentação de Workloads.

Aponte o Domínio para a Azion

www CNAME xxxxxxxxxx.map.azionedge.net

ns1.aziondns.net
ns2.aziondns.com
ns3.aziondns.org

Verifique Propagação

dig www.seudominio.com CNAME +short

Documentação de referência

• Workloads
• Crie um domínio customizado Azion
• Edge DNS
• Certificate Manager

2. Migrando DNS para Edge DNS

A configuração de DNS é fundamental para a entrega de aplicações. Migrar DNS requer planejamento cuidadoso para evitar tempo de inatividade durante a troca de nameservers.

Diferenças Principais

Passos de Migração

# Crie uma zona DNS
curl -X POST 'https://api.azionapi.net/v4/workspace/dns/zones' --header 'Authorization: Token YOUR_TOKEN' --header 'Content-Type: application/json' --data '{
  "name": "my-zone",
  "domain": "example.com",
  "active": true
}'

# Adicione registros DNS
curl -X POST 'https://api.azionapi.net/v4/workspace/dns/zones/{zone_id}/records' --header 'Authorization: Token YOUR_TOKEN' --header 'Content-Type: application/json' --data '{
  "record_type": "A",
  "entry": "www",
  "ttl": 3600,
  "rdata": ["192.168.1.1"]
}'

Mapeamento de Tipos de Registro

Configuração de DNSSEC

Para habilitar DNSSEC:

1. Navegue para sua zona no Edge DNS.
2. Vá para a aba DNSSEC.
3. Habilite DNSSEC.
4. Copie o registro DS para seu registrador.

# Verifique DNSSEC
dig example.com DNSSEC +dnssec

Verifique Propagação

# Verifique propagação de nameserver
dig example.com NS +short

# Verifique registro específico
dig www.example.com A +short

# Verifique de servidor DNS específico
dig @ns1.aziondns.net example.com A

Documentação de referência

• Edge DNS
• Compatibilidade DNSSEC
• Execute o comando dig
• Execute o comando traceroute

3. Migrando SSL/TLS para Certificate Manager

Certificados SSL/TLS garantem comunicação segura entre clientes e sua aplicação. A Azion fornece provisionamento automático de certificados e suporta certificados customizados.

Diferenças Principais

Provisionamento Automático de Certificado

A Azion provisiona automaticamente certificados Let’s Encrypt para domínios customizados:

# Crie um workload com configuração TLS
# Primeiro, crie um certificado via Certificate Manager, depois referencie-o por ID
curl -X POST 'https://api.azionapi.net/v4/workspace/workloads' --header 'Authorization: Token YOUR_TOKEN' --header 'Content-Type: application/json' --data '{
  "name": "my-workload",
  "domains": ["www.example.com"],
  "tls": {
    "certificate": 12345,
    "minimum_version": "tls12",
    "ciphers": 1
  },
  "active": true,
  "infrastructure": 1
}'

Upload de Certificado Customizado

Para organizações com certificados existentes:

# Upload de certificado customizado
curl -X POST 'https://api.azionapi.net/v4/workspace/tls/certificates' --header 'Authorization: Token YOUR_TOKEN' --header 'Content-Type: application/json' --data '{
  "name": "my-custom-cert",
  "certificate": "-----BEGIN CERTIFICATE-----
...
-----END CERTIFICATE-----",
  "private_key": "-----BEGIN PRIVATE KEY-----
...
-----END PRIVATE KEY-----"
}'

Configuração de mTLS

Para autenticação mutual TLS:

1. Navegue para Certificate Manager.
2. Faça upload do seu certificado CA como Trusted CA.
3. Configure seu workload para requerer certificados de cliente.
4. Veja o guia de configuração mTLS para passos detalhados.

Documentação de referência

• Certificate Manager
• Firewall Certificate Manager
• Crie um certificado digital
• mTLS

4. Migrando WAF para Web Application Firewall

Web Application Firewall protege aplicações de tráfego malicioso, injeção SQL, cross-site scripting (XSS) e outros ataques de camada de aplicação. Migrar regras WAF requer mapeamento cuidadoso da lógica de regras e compreensão das diferenças na construção de regras.

Diferenças Principais

Passos de Migração

# Crie uma instância WAF
curl -X POST 'https://api.azion.com/v4/workspace/wafs' --header 'Accept: application/json' --header 'Authorization: Token [TOKEN]' --header 'Content-Type: application/json' --data '{
  "active": true,
  "name": "My WAF",
  "product_version": "1.0",
  "engine_settings": {
    "engine_version": "2021-Q3",
    "type": "score",
    "attributes": {
      "rulesets": [1],
      "thresholds": [
        { "threat": "sql_injection", "sensitivity": "medium" }
      ]
    }
  }
}'

Exemplo de Migração de Regra

Converta regra de firewall Cloudflare para Azion Rules Engine:

Expressão Cloudflare:

(http.request.uri.path contains "/admin" and not ip.src in {10.0.0.0/8})

Critérios Azion:

Variável: ${uri}
Operador: matches
Argumento: /admin

AND

Variável: ${remote_addr}
Operador: does not match
Argumento: 10.0.0.0/8

Documentação de referência

• Web Application Firewall
• Rules Engine para Firewall
• Functions para Firewall

5. Migrando Proteção DDoS

Proteção DDoS protege contra ataques volumétricos, ataques de protocolo e ataques de camada de aplicação. A Azion fornece mitigação DDoS automática sem necessidade de configuração para a maioria dos tipos de ataque.

Diferenças Principais

Proteção Automática

O Azion DDoS Protection ativa automaticamente para todas as aplicações. Nenhuma configuração manual é necessária para proteção padrão contra:

• Ataques volumétricos (UDP floods, ICMP floods)
• Ataques de protocolo (SYN floods, packet fragmentation)
• Ataques de camada de aplicação (HTTP floods, slowloris)

Configuração Avançada

Para aplicações que requerem políticas DDoS específicas:

# Proteção DDoS é configurada como um módulo dentro do Firewall
# Atualize o Firewall com configurações do módulo DDoS
curl -X PATCH 'https://api.azion.com/v4/workspace/firewalls/{firewall_id}' --header 'Authorization: Token YOUR_TOKEN' --header 'Content-Type: application/json' --data '{
  "modules": {
    "ddos_protection": {
      "enabled": true,
      "sensitivity": "high"
    }
  }
}'

Network Shield

Para proteção de nível de rede, use o Azion Network Shield:

• Fornece proteção DDoS L3/L4
• Trabalha com Edge DNS para filtragem de tráfego
• Integra com Firewall para segurança unificada

Documentação de referência

• DDoS Protection
• DDoS Mitigation
• Network Shield

6. Migrando Gerenciamento de Bots

Gerenciamento de bots protege aplicações de ameaças automatizadas enquanto permite bots legítimos. O Azion Bot Manager fornece capacidades de detecção, desafio e mitigação.

Diferenças Principais

Bot Manager Lite (Marketplace)

Para proteção básica de bots, instale o Bot Manager Lite do Azion Marketplace:

Regras Customizadas de Bot

Crie regras customizadas para lidar com bots específicos:

Critérios: ${user_agent} contains "BadBot"
Comportamento: Deny (403)

Critérios: ${user_agent} contains "Googlebot"
Comportamento: Allow

Verificação

# Teste detecção de bot
curl -A "BadBot/1.0" https://seudominio.com/
# Esperado: 403 Forbidden ou página de challenge

curl -A "Mozilla/5.0" https://seudominio.com/
# Esperado: Resposta normal

Documentação de referência

• Bot Manager
• Bot Manager Lite
• Kit de integração Bot Manager Lite
• Radware Bot Manager

7. Migrando Rate Limiting

Rate limiting protege aplicações de abuso limitando taxas de requisições por cliente. A Azion fornece rate limiting através de regras de Firewall e Functions.

Diferenças Principais

Rate Limiting Baseado em Firewall

Configure rate limiting no Firewall Rules Engine:

# Crie regra de rate limiting
curl -X POST 'https://api.azionapi.net/v4/workspace/firewalls/{firewall_id}/request_rules' --header 'Authorization: Token YOUR_TOKEN' --header 'Content-Type: application/json' --data '{
  "name": "Rate Limit API",
  "criteria": [[{"variable": "${uri}", "operator": "starts_with", "argument": "/api/"}]],
  "behaviors": [
    {"type": "rate_limit", "attributes": {"rps": 100, "window": 60, "action": "block"}}
  ]
}'

Documentação de referência

• Rules Engine para Firewall
• Functions para Firewall
• Functions Instances para Firewall

Store

A categoria Store cobre serviços de dados. Migre dados key-value, objetos e SQL com atenção à consistência, padrões de acesso e compatibilidade de aplicação.

1. Migrando Workers KV com KV Store

Armazenamento key-value é usado para acesso rápido a configuração, preferências de usuário, metadados de sessão, feature flags e dados de personalização. A migração deve preservar consistência de dados e compatibilidade de aplicação.

Comparação de API

// Antes: Cloudflare
await env.MY_KV_NAMESPACE.put('key1', 'value1');
const value = await env.MY_KV_NAMESPACE.get('key1');

// Depois: Azion
import { KVStore } from 'azion:kv';

const kv = new KVStore('my-store');
await kv.put('key1', 'value1');
const value = await kv.get('key1');

Exportar e Importar

Exporte dados KV existentes através da API da Cloudflare. Antes de importar, revise:

• Convenções de nomenclatura de chaves e prefixos
• Lógica de expiração
• Formatos de valor e estrutura de objetos serializados
• Comportamento de chaves ausentes e valores padrão

Documentação de referência

• KV Store (módulo azion
  )
• Functions
• Runtime APIs

2. Migrando R2 com Object Storage

Object storage suporta arquivos que importam para usuários e operações de negócio: imagens, documentos, assets estáticos, arquivos de mídia, uploads e conteúdo gerado.

Diferenças Principais

Atualize Configuração

import { S3Client } from '@aws-sdk/client-s3';

const client = new S3Client({
region: 'us-east-005',
endpoint: 'https://s3.us-east-005.azionstorage.net',
credentials: {
  accessKeyId: Azion.env.get('AZION_ACCESS_KEY'),
  secretAccessKey: Azion.env.get('AZION_SECRET_KEY')
}
});

Migre Dados com s3cmd

s3cmd é uma ferramenta de linha de comando para gerenciar serviços de storage compatíveis com S3. É uma opção eficaz para migrar dados do Cloudflare R2 para o Azion Object Storage.

1. Instale s3cmd e execute s3cmd --configure para configurar suas credenciais Azion:

• Access Key / Secret Key: Insira as chaves geradas para o Azion Object Storage.
• Default Region: us-east-005 (s3cmd também aceita us-east para configuração interativa).
• S3 Endpoint: s3.us-east-005.azionstorage.net.
• DNS template: %(bucket).s3.us-east-005.azionstorage.net.
• Use HTTPS protocol: true.

2. Use os seguintes comandos para migrar seus dados:

Documentação de referência

• Object Storage
• Como acessar Object Storage usando o protocolo S3
• Crie e modifique um bucket
• Faça upload e download de objetos
• Use um bucket como origem
• Referência da biblioteca Storage

3. Migrando D1 com SQL Database

Migração de banco de dados toca o núcleo do estado da aplicação. O Azion SQL Database é compatível com SQLite, ACID-compliant e usa uma arquitetura distribuída Main/Replicas.

Diferenças Principais

Atualize Seu Código

// Antes: Cloudflare
const result = await env.DB
.prepare('SELECT * FROM users WHERE id = ?')
.bind(1)
.first();

// Depois: Azion
import { Database } from 'azion:sql';

const db = new Database('my-database');
const result = await db
.prepare('SELECT * FROM users WHERE id = ?')
.bind(1)
.first();

Exportar e Importar

# Exporte do D1
wrangler d1 export my-db --output=dump.sql

# Importe para Azion (via SQL Shell CLI ou workflow de migração)

Documentação de referência

• SQL Database
• Vector Search
• Crie um banco de dados
• Instale SQL Shell
• Comandos SQL Database Shell
• Importe dados para o SQL Database

Observe

A categoria Observe cobre analytics, métricas e logs. Migrar observabilidade garante que você mantenha visibilidade de produção, capacidades de troubleshooting e relatórios de conformidade após o cutover.

1. Migrando Analytics para Real-Time Metrics

Analytics fornecem visibilidade do desempenho da aplicação, padrões de tráfego e comportamento do usuário. A Azion oferece observabilidade abrangente através de Real-Time Metrics, Real-Time Events e GraphQL API.

Diferenças Principais

Métricas Disponíveis

O Azion Real-Time Metrics rastreia:

• Métricas de requisição: Total de requisições, requisições por código de status, requisições por método HTTP
• Métricas de performance: Tempo de resposta, upstream header time (equivalente a TTFB), tempo de resposta da origem
• Métricas de bandwidth: Dados transferidos, dados economizados pelo cache
• Métricas de cache: Hit ratio, miss ratio, objetos expirados
• Métricas de erro: Erros 4xx, erros 5xx, erros de origem

query HttpMetricsQuery {
httpMetrics(
  limit: 10,
  filter: {
    tsRange: {begin: "2024-01-01T00:00:00", end: "2024-01-02T00:00:00"}
  }
  aggregate: {sum: requests}
  groupBy: [ts]
) {
  ts
  sum
}
}

Documentação de referência

• Real-Time Metrics
• Real-Time Metrics primeiros passos
• Historical Real-Time Metrics
• Analise métricas
• Plugin Grafana dashboards customizados
• Plugin Grafana dashboards prontos
• Edge Pulse

2. Migrando Logs para Real-Time Events

Dados de log são essenciais para debugging, análise de segurança e conformidade. O Real-Time Events fornece acesso imediato a logs através do Console ou GraphQL API para troubleshooting e investigação em tempo real.

Diferenças Principais

Acesse Real-Time Events

query HttpEvents {
workloadEvents(
  limit: 100,
  filter: {
    tsRange: {begin: "2024-01-01T00:00:00", end: "2024-01-01T01:00:00"}
  }
) {
  ts
  remoteAddress
  requestUri
  status
  upstreamResponseTime
}
}

Documentação de referência

• Real-Time Events
• Real-Time Events primeiros passos
• Investigue requisições com a GraphQL API
• Configure sampling

3. Migrando Logs para Data Stream

Data Stream exporta logs continuamente para destinos externos para armazenamento de longo prazo, análise e integração com sistemas externos de monitoramento e segurança.

Diferenças Principais

Configure Data Stream

# Crie um Data Stream
curl -X POST 'https://api.azion.com/v4/workspace/stream/streams' --header 'Authorization: Token YOUR_TOKEN' --header 'Content-Type: application/json' --data '{
  "name": "My Log Stream",
  "source": {
    "type": "applications"
  },
  "template_id": 12345,
  "endpoint": {
    "type": "s3",
    "name": "my-s3-endpoint",
    "bucket": "my-logs-bucket",
    "region": "us-east-1",
    "access_key": "YOUR_ACCESS_KEY",
    "secret_key": "YOUR_SECRET_KEY"
  },
  "active": true
}'

Destinos Suportados

Data Stream suporta mais de 10 destinos:

• Cloud Storage: Amazon S3, Azure Blob Storage, Azion Object Storage
• Monitoring: Datadog, Splunk, Elasticsearch, Azure Monitor
• Streaming: AWS Kinesis Data Firehose, Apache Kafka
• Analytics: Google BigQuery
• Security: IBM QRadar
• Custom: HTTP Webhook, Standard HTTP/HTTPS POST

Documentação de referência

• Data Stream
• Data Stream primeiros passos
• Use Data Stream
• Conectores: Amazon S3, Azion Object Storage, Datadog, Splunk, Elasticsearch, Kinesis, BigQuery

Troubleshooting

Problemas Comuns

Principais Vantagens Após a Migração

Migrar da Cloudflare para a Azion é direto para a maioria das aplicações modernas, especialmente aquelas usando Workers, KV, R2 ou D1. O objetivo imediato da migração é continuidade — sua aplicação deve continuar funcionando, usuários devem continuar acessando as mesmas experiências e fluxos críticos de negócio devem permanecer estáveis.

Mas o maior valor vem após a migração, quando a equipe começa a operar em uma plataforma mais unificada.

Com a Azion, equipes podem construir e rodar aplicações em infraestrutura distribuída globalmente enquanto combinam capacidades de compute, entrega, storage, banco de dados, segurança e observabilidade em um ambiente. Isso reduz a fragmentação que frequentemente aparece quando aplicações modernas dependem de muitos serviços separados e padrões de configuração.

Functions podem interagir com serviços de plataforma como KV Store e SQL Database. Applications podem usar Rules Engine para roteamento, redirecionamentos e headers. Object Storage pode suportar assets estáticos, mídia e arquivos gerados por usuários. Capacidades de segurança podem proteger workloads. Real-Time Metrics e Events podem dar às equipes visibilidade do que está acontecendo em produção.

Para líderes de engenharia, isso significa mais clareza operacional. Para desenvolvedores, significa um workflow mais coeso. Para equipes de infraestrutura e segurança, significa controle mais forte sobre como aplicações são entregues e protegidas. Para o negócio, significa uma fundação de plataforma que pode suportar crescimento sem adicionar complexidade desnecessária a cada ciclo de release.

Próximos Passos

Após sua migração estar completa:

• Revise Real-Time Metrics para monitorar desempenho da aplicação
• Configure Real-Time Events para visibilidade de produção
• Configure Web Application Firewall para segurança de produção
• Revise os guias de recursos individuais para configuração avançada

Comece com um Projeto Pequeno

A melhor forma de começar não é com a aplicação mais complexa do seu portfólio. Comece com um projeto que seja significativo o suficiente para validar o caminho de migração, mas pequeno o suficiente para mover rapidamente e com segurança.

Escolha uma aplicação ou workload que inclua peças representativas da sua arquitetura: um processo de build, alguns redirecionamentos, variáveis de ambiente, talvez uma function e uma quantidade gerenciável de dados. Use esse projeto para validar o workflow, documentar o processo e identificar padrões internos que sua equipe pode reutilizar.

A partir daí, expanda gradualmente. Migre rotas mais complexas. Mova functions adicionais. Traga storage e workloads de banco de dados. Adicione observabilidade. Revise regras de segurança. Então prepare cutovers de produção com maior confiança.

Próximos Passos Recomendados

• Crie sua conta gratuita Azion
• Leia a documentação de Applications
• Explore o Azion CLI
• Junte-se à comunidade Azion

Precisa de Ajuda?

Obtenha ajuda da equipe de Suporte Azion, ou junte-se à nossa comunidade Discord para ver como outros estão usando a Azion.