Skip to main content
O App Storage é o armazenamento de objetos integrado do Replit que permite que seu app hospede e salve facilmente uploads como imagens, vídeos e documentos. Buckets são contêineres para armazenar objetos, como arquivos. Eles incluem políticas de acesso para limitar quais ações usuários ou aplicações podem executar sobre seu conteúdo.
Object Storage agora se chama App Storage.
Com o App Storage, você pode criar apps como:
  • Plataformas de compartilhamento de fotos: permita que criadores façam upload, armazenem e exibam imagens
  • Serviços de streaming de vídeo: gerencie uploads de vídeo e forneça conteúdo aos espectadores
  • Sistemas de gerenciamento de documentos: armazene e organize arquivos de criadores com acesso seguro
  • Sites de portfólio: exiba trabalhos com arquivos de mídia que carregam de forma confiável
  • Serviços de backup de arquivos: forneça aos criadores armazenamento em nuvem para seus arquivos importantes
Peça ao Agent para adicionar App Storage ao seu app com detalhes sobre quais tipos de arquivo seu app deve gerenciar. O Agent configurará a integração, criará os buckets necessários e atualizará seu app para fazer upload, armazenar e recuperar arquivos com recursos avançados como autenticação e controles de acesso.
A ferramenta App Storage permite que você compartilhe dados entre os ambientes de desenvolvimento e produção do mesmo Replit App. Cada bucket pertence a um projeto e não pode ser compartilhado entre apps.

​
Recursos

O App Storage é baseado no Google Cloud Storage (GCS). Isso significa que você recebe os benefícios de disponibilidade, tempo de atividade e segurança líderes do setor.
O App Storage oferece os seguintes recursos para seus Replit Apps:
  • Armazenamento em nuvem persistente: armazene arquivos que permanecem acessíveis ao seu app publicado e aos usuários
  • Gerenciamento de arquivos escalável: atenda às necessidades crescentes de dados sem se preocupar com limites de armazenamento
  • Acesso programático: faça upload, download e gerencie arquivos usando APIs intuitivas
  • Integração avançada com o Agent: deixe o Agent configurar o App Storage com configurações avançadas, inspecionar configurações existentes e gerar código completo de back-end e front-end com autenticação e controles de acesso
Aqui estão algumas maneiras de usar o App Storage nos seus Replit Apps:
  • Armazenar fotos de perfil de criadores e uploads de mídia
  • Servir imagens de produtos para sites de e-commerce
  • Gerenciar uploads de documentos para envios de formulários
  • Criar recursos de compartilhamento e colaboração de arquivos
  • Criar sistemas de gerenciamento de conteúdo com bibliotecas de mídia
Integração avançada com o Agent: você pode pedir ao Replit Agent para adicionar automaticamente o App Storage aos seus apps! O Agent agora pode configurar o armazenamento de objetos, inspecionar configurações e gerar código completo de back-end e front-end com recursos avançados como autenticação e controles de acesso. Basta mencionar “App Storage” ou “armazenamento de arquivos” no seu prompt.Saiba mais sobre integrações do Agent e veja todos os prompts de App Storage disponíveis.

​
Uso

Seu Replit App precisa se autenticar com o Google Cloud Storage para acessar um bucket e seus objetos. Use as bibliotecas de cliente oficiais do App Storage do Replit para autenticar automaticamente.
Você pode acessar a ferramenta App Storage diretamente no seu Project Editor.
Na aba Tools:
  1. Selecione Tools no cabeçalho do painel.
  2. Em Replit Cloud, selecione Ícone do App Storage App Storage.
A aba Tools aberta no Project Editor com App Storage selecionado em Replit Cloud na barra lateral Tools
A partir de uma nova aba:
  1. Selecione + na barra de abas.
  2. Digite “App Storage” em Search tools e selecione-o nos resultados.
Para associar um novo bucket de armazenamento ao seu Replit App, crie um bucket.
Na ferramenta App Storage:
  1. Clique em Create new bucket.
  2. Digite um nome para o bucket no campo Name e selecione Create bucket.
A aba App Storage deve se parecer com a captura de tela a seguir:
Um bucket vazio do App Storage na visualização Objects, com os controles Upload files, Upload folder, Create folder, Search e Refresh acima da mensagem No objects
Para criar buckets adicionais, abra o menu suspenso de buckets no canto superior esquerdo da aba App Storage e selecione Create new bucket.
As seções a seguir explicam as opções de gerenciamento de buckets e objetos na ferramenta App Storage.

​
Selecionar um bucket

Para alternar entre os buckets de armazenamento do seu projeto, selecione o menu suspenso no canto superior esquerdo da aba App Storage. O bucket selecionado exibe uma marca de seleção ao lado do seu nome.

​
Acessar o ID do bucket

Para visualizar o Bucket ID, selecione a visualização Settings no menu suspenso no topo da aba App Storage. O Bucket ID identifica exclusivamente o bucket, que seu código deve referenciar para realizar uma operação. Se você tiver vários buckets, selecione o bucket correto no menu suspenso no canto superior esquerdo. A captura de tela a seguir mostra o Bucket ID do bucket “docs-demo-bucket”:
A visualização Settings da ferramenta App Storage mostrando o Bucket ID do docs-demo-bucket

​
Fazer upload ou download de objetos

Para fazer upload de um objeto para o bucket selecionado:
  1. Navegue até a visualização Objects na aba App Storage.
  2. Selecione ícone de upload de arquivo Upload files, ou ícone de upload de pasta Upload folder para fazer upload de todos os arquivos de uma pasta. Em seguida, selecione um ou mais arquivos para fazer upload na caixa de diálogo de arquivos. Alternativamente, arraste um arquivo ou pasta para a área que lista o conteúdo do bucket.
Para fazer download de um objeto do bucket selecionado:
  1. Navegue até a visualização Objects na aba App Storage.
  2. Selecione o ícone ícone de download de download à direita do arquivo para baixá-lo.

​
Organizar objetos em pastas

Para criar uma pasta no bucket selecionado:
  1. Navegue até a visualização Objects na aba App Storage.
  2. Selecione ícone de criar pasta Create folder na visualização Objects.
  3. Digite um nome para a pasta.
Para adicionar objetos a uma pasta na visualização Objects, arraste um objeto até a pasta de destino. Para mover um objeto para uma pasta pai, arraste-o até o nome dessa pasta no breadcrumb acima da lista de objetos. Por exemplo, para mover product_demo.mov da pasta videos para o nível superior do bucket, arraste-o até Objects no breadcrumb.

​
Excluir objetos ou buckets

A ação de exclusão é irreversível. Certifique-se de fazer backup de qualquer dado essencial antes de continuar.
Para excluir um objeto permanentemente:
  1. Navegue até a visualização Objects na aba App Storage.
  2. Selecione o ícone ícone de lixeira de lixeira ao lado do objeto que você deseja excluir.
  3. Confirme a exclusão na caixa de diálogo de confirmação.
Para excluir um bucket e todos os objetos que ele contém:
  1. Navegue até a visualização Settings na aba App Storage.
  2. Certifique-se de selecionar o bucket que deseja excluir no menu suspenso de buckets no canto superior esquerdo.
  3. Selecione ícone de lixeira Delete Bucket.
  4. Confirme a exclusão na caixa de diálogo de confirmação.

​
Copiar trechos de código

A visualização Commands mostra código pronto para uso para operações comuns do App Storage, como fazer upload, download, listar e excluir objetos.
  1. Selecione a visualização Commands no menu suspenso no topo da aba App Storage.
  2. Selecione JavaScript, Python ou All other languages.
  3. Se o pacote de cliente do App Storage ainda não estiver instalado, selecione Install package para adicioná-lo ao seu projeto.
  4. Copie o trecho da operação de que você precisa.

​
Gerenciamento de acesso a buckets

Cada bucket do App Storage é exclusivo do projeto em que você o cria. Não é possível vincular esse bucket a outro projeto, mesmo que ambos os projetos pertençam à mesma conta. Para usar o App Storage em outro projeto, crie um bucket separado na ferramenta App Storage desse projeto.

​
Acesso programático ao App Storage

Para acessar o App Storage a partir do seu Replit App, use uma das seguintes bibliotecas: Para instruções sobre como usar as bibliotecas de cliente, veja os seguintes recursos:

​
Acesso e segurança

​
Os buckets são privados

Os buckets do App Storage são sempre privados, por isso a ferramenta App Storage não tem uma configuração de privacidade. O Replit cria cada bucket com a prevenção de acesso público do Google Cloud Storage aplicada. Isso bloqueia leituras anônimas e rejeita qualquer concessão a allUsers ou allAuthenticatedUsers.
Seu app controla quem pode acessar seus arquivos. Qualquer pessoa com uma URL assinada pode usá-la até que expire, e qualquer rota pública que retorne arquivos armazenados os expõe. Emita URLs assinadas e sirva arquivos somente para usuários que seu app tenha autorizado.

​
Permissões e configurações do bucket

Seu app pode fazer upload, download, listar e excluir objetos nos próprios buckets. Ele não pode ler nem alterar as configurações do bucket, então chamadas como storage.buckets.get ou storage.buckets.getIamPolicy retornam 403 Forbidden. Isso é esperado: essas permissões não estão disponíveis para apps. O App Storage não oferece suporte a regras de ciclo de vida, versionamento de objetos ou políticas de retenção. Para limpar arquivos temporários, use um Scheduled deployment que exclua objetos mais antigos que uma idade definida.

​
Faturamento e uso de recursos

Para monitorar seu uso de App Storage, abra Usage. Para saber mais sobre os preços do App Storage, veja App Storage Billing.