Use um bucket como origem de uma aplicação

Sirva os objetos de um bucket do Object Storage por uma aplicação, com um connector do tipo storage e uma regra do Rules Engine que envia requisições a ele.

Última atualização

Ver como Markdown Configurar agente

Você pode servir os objetos de um bucket do Object Storage por uma aplicação ao combinar um connector para o bucket com uma regra do Rules Engine. Uma requisição para o domínio do workload que serve a aplicação passa então a retornar o objeto armazenado sob a chave correspondente. Para conectar uma aplicação a um servidor HTTP em vez de um bucket, consulte Conecte uma aplicação a uma origem.

Uma conta que não migrou para a API v4 monta o mesmo caminho pelas Origins legadas da aplicação. Para mais informações, consulte Origins.

Escolha a interface em que você trabalha. Os pré-requisitos e os procedimentos mudam conforme a sua escolha.

Pré-requisitos

  • Um bucket cujo workloads_access é read_only ou read_write. Um bucket restricted não pode servir de origem para uma aplicação. Para criar um bucket, consulte Primeiros passos com Object Storage.
  • Uma aplicação servida por um workload. Para criar os dois, consulte Primeiros passos com Applications.
  • Um personal token, enviado no header Authorization como Token [TOKEN VALUE], porque esta página faz upload dos objetos com a API. Para criar um token, consulte Gerencie um personal token.
  • curl ou outro cliente HTTP.
  • O ID da aplicação. Azion Console mostra o ID no endereço da página da aplicação, depois de /applications/edit/.

Faça upload dos objetos a servir

O connector serve o que o bucket já guarda, então os objetos entram primeiro. O exemplo desta página serve uma página de dois objetos, ambos armazenados sob o prefixo src de um bucket chamado app-origin:

Texto
01src/index.html
02src/styles/style.css

Em um diretório local src, crie index.html. A página vincula a folha de estilos dela por um caminho relativo:

HTML
01<!DOCTYPE html>
02<html lang="en">
03<head>
04 <meta charset="UTF-8">
05 <meta name="viewport" content="width=device-width, initial-scale=1.0">
06 <title>Document</title>
07 <link rel="stylesheet" href="styles/style.css">
08</head>
09<body>
10 <h1>Hello world!</h1>
11 <p>I am an object from a bucket.</p>
12</body>
13</html>

Em um diretório styles dentro de src, crie style.css, o arquivo que a página vincula:

CSS
01body {
02 background-color: black;
03}
04
05h1,
06p {
07 color: white;
08}

Para fazer upload do arquivo HTML com a API, envie uma requisição POST com a chave do objeto no caminho. Content-Type define o tipo com que o objeto é armazenado e servido:

Shell
01curl --request POST \
02 --url https://api.azion.com/v4/workspace/storage/buckets/app-origin/objects/src/index.html \
03 --header 'Accept: application/json' \
04 --header 'Authorization: Token [TOKEN VALUE]' \
05 --header 'Content-Type: text/html' \
06 --data-binary '@./src/index.html'

A API responde 201 com a chave sob a qual o objeto é armazenado:

JSON
01{
02 "state": "executed",
03 "data": {
04 "object_key": "src/index.html"
05 }
06}

Para fazer upload da folha de estilos, envie a mesma requisição com a chave e o tipo dela:

Shell
01curl --request POST \
02 --url https://api.azion.com/v4/workspace/storage/buckets/app-origin/objects/src/styles/style.css \
03 --header 'Accept: application/json' \
04 --header 'Authorization: Token [TOKEN VALUE]' \
05 --header 'Content-Type: text/css' \
06 --data-binary '@./src/styles/style.css'

A resposta traz a chave do segundo objeto:

JSON
01{
02 "state": "executed",
03 "data": {
04 "object_key": "src/styles/style.css"
05 }
06}

O bucket guarda os dois objetos. O segmento src/ de cada chave faz parte da chave, não é uma pasta, e a plataforma o cria junto com o objeto. Sem um header Content-Type, a plataforma detecta o tipo do objeto. Azion Console e Azion CLI também fazem upload de objetos. Para mais informações, consulte Primeiros passos com Object Storage.

Crie um connector para o bucket

Um connector para um bucket nomeia o bucket do qual uma aplicação lê e o prefixo dentro dele. O prefixo define onde os caminhos da aplicação começam. Com o prefixo /src, o objeto armazenado sob src/index.html responde em /index.html, e src/styles/style.css responde em /styles/style.css. O prefixo é opcional na API e obrigatório no Azion Console.

No Azion Console, você configura connectors no menu Connectors, e não em uma aba da aplicação. Para cada campo do formulário do Console e do corpo da requisição, consulte Configurações de connector.

Na API, o type do connector é storage, e os attributes dele carregam bucket, o nome do bucket, e prefix. No exemplo desta página, bucket é app-origin e prefix é /src.

Crie o connector com uma requisição POST para /v4/workspace/connectors. Em seguida, copie o ID do connector, que a API retorna em data.id: a regra que envia as requisições para o bucket nomeia o connector por esse ID.

Para criar o connector pelo Azion Console:

Abra a página Connectors

Acesse Azion Console > Connectors.

Inicie um novo connector
Nomeie o connector

Na seção General, insira app-origin-connector em Name.

Selecione o tipo Object Storage

Na seção Connector Type, selecione Object Storage.

Selecione o bucket

Selecione app-origin como o bucket do qual o connector lê.

Defina o prefixo

Insira /src em Prefix, o prefixo sob o qual você fez upload dos objetos.

Selecione Create

Azion Console mostra Connector successfully created.

Envie as requisições para o bucket

Um connector não recebe nenhuma requisição até que uma regra o defina. A regra desta seção roda na fase de requisição da aplicação. O critério dela corresponde a todo caminho, com a variável ${uri}, o operador starts_with e / como argumento, então a aplicação inteira lê do bucket. O behavior dela define o connector.

A variável ${uri} funciona em toda aplicação. Um critério com ${request_uri} precisa de Application Accelerator ativado na aplicação. Para todas as variáveis e operadores, consulte Rules Engine para Applications.

Para criar a regra com a API, envie uma requisição POST para o endpoint request_rules da aplicação. Substitua <application-id> pelo ID da sua aplicação e <connector-id> pelo ID do connector para o bucket:

Shell
01curl --request POST \
02 --url https://api.azion.com/v4/workspace/applications/<application-id>/request_rules \
03 --header 'Accept: application/json' \
04 --header 'Authorization: Token [TOKEN VALUE]' \
05 --header 'Content-Type: application/json' \
06 --data {
07 "name": "serve-the-bucket",
08 "active": true,
09 "criteria": [
10 [
11 {
12 "variable": "${uri}",
13 "conditional": "if",
14 "operator": "starts_with",
15 "argument": "/"
16 }
17 ]
18 ],
19 "behaviors": [
20 {
21 "type": "set_connector",
22 "attributes": {
23 "value": <connector-id>
24 }
25 }
26 ]
27}

A API responde 202 e retorna a regra:

JSON
01{
02 "state": "pending",
03 "data": {
04 "id": <rule-id>,
05 "name": "serve-the-bucket",
06 "active": true,
07 "criteria": [
08 [
09 {
10 "conditional": "if",
11 "variable": "${uri}",
12 "operator": "starts_with",
13 "argument": "/"
14 }
15 ]
16 ],
17 "behaviors": [
18 {
19 "type": "set_connector",
20 "attributes": {
21 "value": <connector-id>
22 }
23 }
24 ],
25 "description": "",
26 "order": 0,
27 "last_editor": "user@example.com",
28 "last_modified": "2026-01-01T12:00:26.750242Z",
29 "created_at": "2026-01-01T12:00:26.750262Z"
30 }
31}

A regra é a primeira da fase de requisição da aplicação, com order 0.

Para criar a regra pelo Azion Console:

Abra a aplicação

Acesse Azion Console > Applications e selecione a sua aplicação.

Selecione a aba Rules Engine
Inicie uma regra

Selecione + Rule.

Nomeie a regra

Na seção General, insira um Name, como serve-the-bucket.

Selecione a fase

Na seção Phase, selecione Request Phase. Uma regra mantém a fase em que é criada.

Defina o critério

Na seção Criteria, defina a variável como ${uri}, o operador como starts_with e o argumento como /.

Defina o connector

Na seção Behaviors, selecione Set Connector e, em seguida, selecione o connector para o bucket em Connector.

Salve a regra

Selecione Save.

A regra aparece na aba Rules Engine da aplicação, sob Request.

Para o behavior e os atributos dele, consulte Set Connector.

Confirme que a aplicação serve o bucket

A regra leva algum tempo para propagar. Até lá, o domínio do workload não responde com os objetos.

Para confirmar o caminho de entrega, requisite a página pelo domínio do seu workload, com esse domínio no lugar de <your-workload-domain>:

curl https://<your-workload-domain>/index.html

O corpo da resposta é o objeto armazenado sob src/index.html, que o prefixo /src serve em /index.html. Ele traz o título Hello world! e o parágrafo I am an object from a bucket. O domínio de um workload termina em .map.azionedge.net, e a API o retorna em workload_domain quando cria o workload.

Acesse o mesmo endereço em um navegador. O navegador renderiza a página com a folha de estilos aplicada, que ele carrega de /styles/style.css sob o mesmo prefixo.

Se o domínio ainda não retorna o objeto, a regra não propagou. Envie a requisição de novo e procure outra causa somente depois disso. Para mais informações, consulte Solucionar problemas de Applications.

Próximos passos

Cache settingsDefina por quanto tempo os objetos que a aplicação serve ficam em cache.ConnectorsTodos os campos de um connector para um bucket e os outros tipos de connector.Como Object Storage funcionaO que o nível de acesso muda e o caminho que uma requisição percorre até um objeto.Buckets e objetosNomes de bucket, níveis de acesso, chaves de objeto e prefixos.