Saltar para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.replit.com/llms.txt

Use this file to discover all available pages before exploring further.

O App Storage é o armazenamento de objetos integrado do Replit que permite ao seu aplicativo hospedar e salvar uploads como imagens, vídeos e documentos com facilidade. Buckets são contêineres para armazenar objetos como arquivos. Eles incluem políticas de acesso para limitar as ações que usuários ou aplicativos podem realizar em seus conteúdos.
Renomeamos o Object Storage para App Storage. A funcionalidade não foi alterada e seus buckets, permissões e acesso programático existentes continuarão funcionando normalmente.
Com o App Storage, você pode criar aplicativos 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 distribua conteúdo para espectadores
  • Sistemas de gerenciamento de documentos: Armazene e organize arquivos dos 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
screenshot of the App Storage tool
Peça ao Agent para adicionar o App Storage ao seu aplicativo com detalhes sobre os tipos de arquivos que seu app deve suportar. O Agent configurará a integração, criará os buckets necessários e atualizará seu aplicativo para fazer upload, armazenar e recuperar arquivos com recursos avançados como autenticação e controles de acesso.
A ferramenta App Storage permite compartilhar dados de forma integrada entre seus ambientes de desenvolvimento e produção ou com outros Replit Apps.

​
Recursos

O App Storage é alimentado pelo Google Cloud Storage (GCS). Isso significa que você recebe os benefícios de uptime, disponibilidade 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 aplicativo publicado e aos usuários
  • Gerenciamento escalável de arquivos: Lide com necessidades crescentes de dados sem se preocupar com limites de armazenamento
  • Compartilhamento de dados entre aplicativos: Compartilhe buckets entre vários Replit Apps para arquiteturas distribuídas
  • Acesso programático: Faça upload, download e gerencie arquivos usando APIs intuitivas
  • Integração aprimorada com o Agent: Permita que o Agent configure o App Storage com configurações avançadas, inspecione configurações existentes e gere código completo de backend e frontend com autenticação e controles de acesso
Veja algumas formas de usar o App Storage em seus Replit Apps:
  • Armazene fotos de perfil e uploads de mídia dos criadores
  • Sirva imagens de produtos para sites de e-commerce
  • Gerencie uploads de documentos para envios de formulários
  • Crie recursos de compartilhamento de arquivos e colaboração
  • Construa sistemas de gerenciamento de conteúdo com bibliotecas de mídia
Integração aprimorada com o Agent: Você pode solicitar ao Replit Agent para adicionar automaticamente o App Storage aos seus aplicativos! O Agent agora pode configurar o armazenamento de objetos, inspecionar configurações e gerar código completo de backend e frontend 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 as integrações do Agent e veja todos os prompts disponíveis para o App Storage.

​
Uso

Seu Replit App deve autenticar-se com o Google Cloud Storage para acessar um bucket e seus objetos. Use as bibliotecas de cliente oficiais do Replit App Storage para autenticar automaticamente.
Você pode acessar a ferramenta App Storage diretamente no Editor de Projetos.
Na Barra de ferramentas à esquerda:
  1. Selecione All tools icon Todas as ferramentas para ver a lista de ferramentas do Editor de Projetos.
  2. Selecione App Storage icon App Storage.
Na Barra de pesquisa:
  1. Selecione a magnifying glass icon lupa na parte superior para abrir a ferramenta de pesquisa.
  2. Digite “App Storage” para localizar a ferramenta e selecione-a 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. Insira um nome para o bucket no campo Name e selecione Create bucket.
A aba App Storage deve ser semelhante à captura de tela a seguir:
screenshot of the App Storage tool
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 seus buckets de armazenamento, selecione o menu suspenso no canto superior esquerdo da aba App Storage. O bucket selecionado exibe uma marca de seleção ao lado do nome, conforme mostrado na captura de tela abaixo:
screenshot of bucket selection menu

​
Acessar o ID do bucket

Para visualizar o ID do Bucket, selecione a visualização Settings no menu suspenso na parte superior da aba App Storage. O ID do Bucket 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 ID do Bucket para o bucket “FileVault Bucket One”:
screenshot of the App Storage tool

​
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 upload file icon Upload files, ou upload folder icon Upload folder para fazer upload de todos os arquivos de uma pasta. Em seguida, selecione um ou mais arquivos para upload na caixa de diálogo de arquivos. Como alternativa, 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 download icon 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 create folder icon Create Folder na visualização Objects.
  3. Insira um nome para a pasta.
Para adicionar objetos a uma pasta na visualização Objects, arraste um objeto para a pasta de destino. Para mover o objeto para uma pasta pai, arraste-o acima do cabeçalho até o nome da pasta acima da lista de objetos. A animação a seguir mostra como mover o arquivo “product_demo.mov” da pasta “videos” para a pasta pai “Objects”:
animation showing moving a file to a parent folder

​
Excluir objetos ou buckets

A ação de exclusão é irreversível. Certifique-se de fazer backup de todos os dados essenciais antes de prosseguir.
Para excluir um objeto permanentemente:
  1. Navegue até a visualização Objects na aba App Storage.
  2. Selecione o ícone trash icon de lixeira ao lado do objeto que 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 trash icon Delete Bucket.
  4. Confirme a exclusão na caixa de diálogo de confirmação.

​
Gerenciamento de acesso ao bucket

O Replit conecta todos os buckets que você cria à sua conta e os disponibiliza para todos os seus Replit Apps. O Replit App a partir do qual você cria o bucket recebe acesso automaticamente. Você pode controlar quais Replit Apps têm acesso a um bucket específico, permitindo compartilhar dados de forma eficiente e segura. Para conceder acesso de um Replit App a um bucket de outro aplicativo em sua conta:
  1. Selecione magnifying glass icon Add an existing bucket no menu de buckets no canto superior esquerdo da aba App Storage.
  2. Na caixa de diálogo Choose a Bucket, escolha o bucket que deseja adicionar e selecione Add Bucket to Repl.
screenshot of the choose bucket dialog
Para revogar o acesso do seu Replit App a um bucket:
  1. Navegue até a visualização Settings na aba App Storage.
  2. No menu suspenso de buckets no canto superior esquerdo da aba, selecione o nome do bucket.
  3. Selecione Remove Bucket from Repl e confirme a remoção na caixa de diálogo de confirmação.

​
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, consulte os seguintes recursos:

​
Faturamento e uso de recursos

Para monitorar o uso do App Storage, navegue até a página Uso. Para saber mais sobre os preços do App Storage, consulte Faturamento do App Storage.