Primeiros passos com Workloads

Crie um workload, vincule a sua aplicação a ele com um deployment e envie a primeira requisição pelo workload domain dele.

Última atualização

Ver como Markdown Configurar agente

Este guia orienta você a atender a sua aplicação a partir do seu primeiro workload.

  • Crie um workload na infraestrutura de produção.
  • Vincule a aplicação que você já tem ao workload por meio do deployment dele.
  • Envie uma requisição para o workload domain e receba a resposta da sua aplicação.

Quatro objetos levam uma requisição até a sua aplicação, e cada um se liga ao seguinte:

  1. O workload recebe o tráfego. A Azion atribui a ele um workload domain, um hostname no formato <id>.map.azionedge.net. O workload responde nele antes que você tenha ou aponte qualquer domínio.
  2. O deployment do workload nomeia a aplicação que responde. Um workload contém um deployment.
  3. A aplicação trata a requisição. Ela já existe, e o workload não acrescenta nada a ela.
  4. A requisição para o workload domain chega ao workload, e o deployment a envia para a sua aplicação.

Um workload sem deployment não tem aplicação para a qual enviar uma requisição. Uma aplicação não atende tráfego até que um deployment a vincule a um workload. Este guia mantém os padrões de um workload novo: a infraestrutura de produção, as configurações de TLS padrão, as portas 80 e 443 e nenhum domínio seu.

O workload que este guia deixa pronto é o ponto de partida de outros dois primeiros passos. Com Certificate Manager, você vincula um certificado ao workload. Com Custom Pages, você atribui um conjunto de custom pages no deployment do workload para substituir respostas de erro. DDoS Protection não precisa de configuração: a plataforma mitiga ataques DDoS em todo workload.

Selecione a interface que você usa. Os pré-requisitos e cada etapa desta página seguem essa escolha.

Pré-requisitos

  • Azion CLI instalada e autorizada.
  • O ID da sua aplicação.
  • Um personal token e curl. Para criar um token, consulte Tokens pessoais.
  • O ID da sua aplicação.

Crie o workload

Um workload novo é executado na infraestrutura de produção e responde no workload domain dele. A infraestrutura fica fixa depois que o workload existe. Um workload criado em staging não pode passar para produção depois. O workload domain continua acessível enquanto Workload Domain Allow Access estiver ativado, que é o padrão.

Para criar o workload com a Azion CLI:

azion create workload --name my-workload

O comando imprime o ID do workload novo:

Created Workload with ID <workload-id>

Leia o workload de volta em JSON. Substitua <workload-id> pelo ID do comando anterior:

azion describe workload --workload-id <workload-id> --format json

A saída mostra os padrões de um workload novo e o workload domain que a Azion atribuiu a ele:

JSON
01{
02 "active": true,
03 "created_at": "2026-01-01T12:00:00.000000Z",
04 "domains": [],
05 "id": <workload-id>,
06 "infrastructure": 1,
07 "last_editor": "<your-email>",
08 "last_modified": "2026-01-01T12:00:00.000000Z",
09 "mtls": {
10 "config": {
11 "certificate": null,
12 "verification": null
13 },
14 "enabled": false
15 },
16 "name": "my-workload",
17 "product_version": "1.0",
18 "protocols": {
19 "http": {
20 "http_ports": [
21 80
22 ],
23 "https_ports": [
24 443
25 ],
26 "quic_ports": [
27 443
28 ],
29 "versions": [
30 "http1",
31 "http2",
32 "http3"
33 ]
34 }
35 },
36 "tls": {
37 "certificate": null,
38 "ciphers": 7,
39 "minimum_version": "tls_1_3"
40 },
41 "workload_domain": "<id>.map.azionedge.net",
42 "workload_domain_allow_access": true
43}

infrastructure definido como 1 é a infraestrutura de produção, e domains está vazio. Anote o id para o deployment e o workload_domain para a requisição. O workload existe e ainda não tem deployment.

Para criar o workload com a API, envie uma requisição POST para o endpoint de workloads. infrastructure definido como 1 seleciona a infraestrutura de produção, e workload_domain_allow_access definido como true mantém o workload domain aberto. Substitua [TOKEN VALUE] pelo seu personal token:

Shell
01curl --request POST \
02 --url https://api.azion.com/v4/workspace/workloads \
03 --header 'Accept: application/json' \
04 --header 'Authorization: Token [TOKEN VALUE]' \
05 --header 'Content-Type: application/json' \
06 --data {
07 "name": "my-workload",
08 "active": true,
09 "infrastructure": 1,
10 "workload_domain_allow_access": true
11}

A API responde com 202. A resposta traz os padrões do workload novo e o workload domain que a Azion atribuiu a ele:

JSON
01{
02 "state": "pending",
03 "data": {
04 "id": <workload-id>,
05 "name": "my-workload",
06 "active": true,
07 "last_editor": "<your-email>",
08 "last_modified": "2026-01-01T12:00:00.000000Z",
09 "created_at": "2026-01-01T12:00:00.000000Z",
10 "infrastructure": 1,
11 "tls": {
12 "certificate": null,
13 "ciphers": 7,
14 "minimum_version": "tls_1_3"
15 },
16 "protocols": {
17 "http": {
18 "versions": ["http1", "http2", "http3"],
19 "http_ports": [80],
20 "https_ports": [443],
21 "quic_ports": [443]
22 }
23 },
24 "mtls": {
25 "enabled": false,
26 "config": {
27 "certificate": null,
28 "crl": null,
29 "verification": null
30 }
31 },
32 "domains": [],
33 "workload_domain_allow_access": true,
34 "workload_domain": "<id>.map.azionedge.net",
35 "product_version": "1.0"
36 }
37}

Anote o id para o deployment e o workload_domain para a requisição. O workload existe e ainda não tem deployment.

No Azion Console, um único formulário cria o workload e o deployment dele ao mesmo tempo. O campo Application de Deployment Settings nomeia a sua aplicação antes de você selecionar Create.

Para criar o workload no Azion Console:

Abra a página Workloads

Acesse Azion Console > Workloads.

Inicie um workload

Selecione Create Workload. A página Create Workload abre.

Nomeie o workload

Digite um nome para o workload, como my-workload.

Selecione a infraestrutura de produção

Em Infrastructure, selecione Production Infrastructure (All Edge Locations).

Mantenha o workload domain aberto

Em Domains, mantenha Workload Domain Allow Access ativado.

Selecione a sua aplicação

Em Deployment Settings, selecione a sua aplicação em Application. Deixe Firewall e Custom Page vazios.

Selecione Create

Azion Console mostra a mensagem “Your Workload has been created. After propagation the domain will be available in the Workload URL. You also can add a custom domain.” Para copiar o workload domain para o qual você envia a requisição, selecione Copy Workload URL. O workload existe, e o deployment dele nomeia a sua aplicação.

Vincule a sua aplicação

O deployment de um workload nomeia a aplicação que responde às requisições dele e, opcionalmente, um firewall e um conjunto de custom pages. Um workload contém um deployment, e um segundo é recusado. Até que o deployment nomeie a sua aplicação, o workload não tem para onde enviar uma requisição.

Para vincular a aplicação com a Azion CLI, crie o deployment do workload. Substitua <workload-id> e <application-id>:

Shell
01azion create workload-deployment --workload-id <workload-id> \
02 --name my-deployment --application-id <application-id> \
03 --strategy-type default --active true --current true

O comando imprime o ID do deployment novo:

Created Workload Deployment with ID <deployment-id>

--current true torna esse o deployment que o workload executa. Liste o deployment com os vínculos dele:

azion list workload-deployment --workload-id <workload-id> --details

A saída mostra a sua aplicação e 0 para nenhum firewall:

Texto
01ID CURRENT EDGE APPLICATION EDGE FIREWALL
02<deployment-id> true <application-id> 0

O deployment atual do workload nomeia a sua aplicação. A Azion CLI não altera um deployment depois que ele existe. Confira o ID da aplicação antes de executar o comando.

Para vincular a aplicação com a API, envie uma requisição POST para os deployments do seu workload. A aplicação vai em strategy.attributes.application. Substitua <workload-id> e <application-id>:

Shell
01curl --request POST \
02 --url https://api.azion.com/v4/workspace/workloads/<workload-id>/deployments \
03 --header 'Accept: application/json' \
04 --header 'Authorization: Token [TOKEN VALUE]' \
05 --header 'Content-Type: application/json' \
06 --data {
07 "name": "my-deployment",
08 "current": true,
09 "active": true,
10 "strategy": {
11 "type": "default",
12 "attributes": {
13 "application": <application-id>
14 }
15 }
16}

A API responde com 202 e "state": "pending", e a resposta retorna o deployment novo. current definido como true torna esse o deployment que o workload executa. O deployment atual do workload nomeia a sua aplicação.

O formulário Create Workload já criou o deployment. Para conferir o vínculo no Azion Console:

Abra a página Workloads

Acesse Azion Console > Workloads.

Abra o seu workload

Selecione o workload que você criou. A página Edit Workload abre.

Confira a aplicação

Em Deployment Settings, confira se Application mostra a sua aplicação.

O deployment do workload nomeia a sua aplicação.

Envie uma requisição para o workload domain

A verificação é a mesma, qualquer que seja a interface que criou o workload. Nos comandos, substitua <your-workload-domain> pelo workload domain do workload que você criou, no formato <id>.map.azionedge.net.

Um workload novo não responde de imediato. O deployment dele se espalha pela infraestrutura distribuída da Azion, e isso leva vários minutos, sem duração garantida. Até lá, o workload domain responde 404 com a página de erro HTML da Azion. Enquanto o deployment se espalha, as respostas à mesma requisição podem alternar entre esse 404 e a resposta da sua aplicação. Envie a requisição de novo até a sua aplicação responder. Para mais informações, consulte Propagação.

Antes que o deployment se propague, uma requisição somente de cabeçalhos recebe a página de erro da Azion:

curl -sI https://<your-workload-domain>/get
Texto
01HTTP/2 404
02server: nginx
03content-type: text/html
04x-azion-request-id: <request-id>
05x-azion-edge-location: <edge-location>

O cabeçalho x-azion-request-id identifica a requisição. Quando o deployment responder, envie uma requisição para o caminho raiz do seu workload domain:

curl -i https://<your-workload-domain>/

A resposta é a que a sua aplicação retorna para /: o status, os cabeçalhos e o corpo. O seu workload atende a sua aplicação no workload domain dele.

Próximos passos

Primeiros passos com Certificate ManagerEnvie o seu primeiro certificado, vincule-o ao seu workload e veja o status dele mudar para active.Primeiros passos com Custom PagesCrie um conjunto de custom pages, atribua-o no deployment do seu workload e veja um 404 ser substituído no lugar.Adicione um domínio a um workloadListe um domínio seu no workload e aponte-o para o workload domain.Configurações de workloadCada campo de um workload e do deployment dele, com o tipo, o padrão e os valores permitidos.