Publicando sites estáticos com Object Storage na Magalu Cloud



This content originally appeared on DEV Community and was authored by Monica Hillman

Hospedar um site estático pode parecer algo que exige servidores, serviços de hospedagem ou configurações complexas. No entanto, para sites simples como portfólios, páginas institucionais ou protótipos de front-end, existe uma alternativa mais direta e econômica: usar um serviço de Object Storage.

O Object Storage é um tipo de armazenamento em nuvem projetado para guardar arquivos como objetos, acessíveis via URL. Cada objeto pode ser acessado individualmente, o que o torna ideal para publicar conteúdos estáticos. A Magalu Cloud oferece esse serviço com suporte a controle de acesso, alta disponibilidade e integração via linha de comando.

Este tutorial ensina como usar o Object Storage da Magalu Cloud para hospedar um site estático.

Pré-requisitos

Antes de começar, você precisa de:

  • Conta na Magalu Cloud

  • mgc-cli instalado e configurado

Passo a Passo

Faça login na CLI

mgc auth login

Crie uma API Key

Antes de qualquer operação, é necessário autenticar a CLI com uma chave de API. Crie e configure uma API Key com os seguintes comandos:

mgc object-storage api-key create chave-para-site
mgc object-storage api-key list

Copie o UUID da chave criada e defina na CLI:

mgc object-storage api-key set <UUID_DA_CHAVE>

Crie um bucket para o site

Com a CLI autenticada, crie um bucket que servirá como repositório para os arquivos do seu site:

mgc object-storage buckets create site-estatico-exemplo

Configure a ACL pública do bucket

Para que os arquivos possam ser acessados publicamente, é necessário que o bucket permita a listagem de objetos. Isso é feito com:

mgc object-storage buckets acl set --dst site-estatico-exemplo --public-read

Essa configuração permite listar os arquivos contidos no bucket, mas não libera o acesso direto aos objetos. Isso será feito individualmente.

Envie os arquivos para o bucket

Acesse a pasta local onde estão os arquivos do seu site. Por exemplo, se os arquivos estão na pasta C:\Projetos\site-estatico, execute os seguintes comandos na CLI para fazer o upload:

mgc object-storage objects upload ./index.html site-estatico-exemplo/index.html
mgc object-storage objects upload ./estilos.css site-estatico-exemplo/estilos.css
mgc object-storage objects upload ./sobre.html site-estatico-exemplo/sobre.html
mgc object-storage objects upload ./imagens/banner.png site-estatico-exemplo/imagens/banner.png

Garanta que os caminhos no segundo argumento (o nome do objeto no bucket) usem barra /, mesmo se você estiver usando um sistema Windows.

Torne os arquivos públicos com ACL

Após o upload, os arquivos ainda não estarão acessíveis publicamente até que você defina permissões específicas para cada objeto:

mgc object-storage objects acl set site-estatico-exemplo/index.html --public-read
mgc object-storage objects acl set site-estatico-exemplo/estilos.css --public-read
mgc object-storage objects acl set site-estatico-exemplo/sobre.html --public-read
mgc object-storage objects acl set site-estatico-exemplo/imagens/banner.png --public-read

Acesse o site pela URL pública

Os arquivos agora podem ser acessados por qualquer pessoa com o link. A URL segue o formato:

https://br-se1.magaluobjects.com/site-estatico-exemplo/index.html

Basta abrir essa URL no navegador para visualizar o site.

Conclusão

Neste tutorial, você aprendeu como hospedar um site estático na Magalu Cloud utilizando o Object Storage e controle de acesso por ACLs. O processo incluiu a criação do bucket, envio dos arquivos, configuração das permissões e acesso público via URL.

Essa abordagem é simples e eficaz para casos em que você deseja publicar conteúdo rapidamente sem configurar servidores. É possível manter o controle de acesso granular e garantir alta disponibilidade com poucos comandos.

Embora tenhamos utilizado ACLs individuais para liberar os arquivos, uma alternativa recomendada para cenários com muitos arquivos ou uploads frequentes é o uso de Bucket Policies, que permitem tornar todos os objetos públicos de uma só vez, inclusive novos arquivos automaticamente.

Por padrão, o conteúdo será acessado pela URL da Magalu Cloud. No entanto, caso você deseje usar um domínio personalizado (como www.seusite.com), é possível configurar um DNS que aponte para os arquivos do bucket usando serviços complementares. Isso pode exigir o uso de proxy reverso, CDN ou ferramentas específicas de roteamento, dependendo do seu cenário.

Para saber mais sobre essas alternativas, o uso de políticas de acesso avançadas, automações e boas práticas, consulte a documentação oficial da Magalu Cloud.


This content originally appeared on DEV Community and was authored by Monica Hillman