Todos os produtos
Search
Central de documentação

Serverless App Engine:Configure OSS storage

Última atualização: Sep 21, 2026

O Object Storage Service (OSS) oferece uma forma econômica de persistir e compartilhar dados entre instâncias de aplicação, com ferramentas intuitivas e um console para gerenciamento visual de buckets. O OSS é ideal para cenários com alta frequência de leitura, como montagem de arquivos de configuração ou disponibilização de arquivos estáticos de frontend.

Pré-requisitos

Pontos de entrada

O procedimento varia conforme o cenário.

Create an application

  1. Acesse o SAE console. No painel de navegação à esquerda, escolha Applications > Applications. Selecione a região e o namespace de destino e clique em Create Application.

  2. Na página do assistente Basic Information, configure as definições obrigatórias e clique em Next: Advanced Settings.

Modify a running application

Aviso

Após reimplantar uma aplicação, ela é reiniciada. Para evitar erros imprevisíveis, como interrupções de negócio, recomendamos realizar implantações fora dos horários de pico.

  1. Acesse o SAE console. No painel de navegação à esquerda, escolha Applications > Application List. Selecione a região e o namespace de destino e clique no nome da aplicação desejada.

  2. Na página Basic Information da aplicação de destino, clique em Deploy Application.

Modify a stopped application

  1. Acesse o SAE console. No painel de navegação à esquerda, escolha Applications > Application List. Selecione a região e o namespace de destino e clique no nome da aplicação desejada.

  2. Na página Basic Information da aplicação de destino, clique em Modify Application Configurations.

Procedimento

Expanda a seção Configure Persistent Storage e ative a opção Enable OSS.

Montar o armazenamento OSS

  1. Insira o AccessKey ID e o AccessKey Secret.

    Como prática recomendada de segurança, use o par de AccessKey de um usuário RAM. Por exemplo, a política mínima a seguir concede a um usuário RAM acesso somente leitura ao diretório oss-test/ no bucket test-sae.

    {
        "Statement": [
            {
                "Action": "oss:GetBucket",
                "Effect": "Allow",
                "Resource": "acs:oss:*:*:test-sae"
            },
            {
                "Action": "oss:GetObject",
                "Effect": "Allow",
                "Resource": "acs:oss:*:*:/"
            }
        ],
        "Version": "1"
    }
  2. Configure as definições de montagem do OSS. Para adicionar várias entradas, clique em Add.

    Parâmetro

    Descrição

    Exemplo

    Bucket

    Um bucket OSS existente.

    bucketname

    Mount Directory

    Um diretório ou objeto OSS existente. Se o diretório de montagem especificado não existir, ocorrerá um erro.

    Exemplos:

    • /

      Nota

      Monta a raiz do bucket.

    • tmp/oss-test/

    • tmp/oss-demo.log

    Container Path

    O caminho no container SAE. Se o caminho existir, seu conteúdo será substituído. Se não existir, ele será criado.

    /home/admin/app/php/

    Permission

    A permissão de acesso ao recurso montado. Valores válidos:

    • read-only

    • read/write

    read-only

Desmontar o armazenamento OSS

É possível desmontar o armazenamento OSS quando ele não for mais necessário. A desmontagem não exclui os dados armazenados no OSS.

Para desmontar uma configuração OSS, localize a entrada que deseja remover e clique no ícone oss-mount-delete-icon na coluna Actions.

Verificação

  • Verifique os detalhes da implantação.

    Uma implantação bem-sucedida sem exceções de instância indica que a montagem foi concluída com êxito.

  • Verifique a partir do interior do container.

    Log on to Webshell e execute o comando a seguir para verificar as informações de montagem do OSS.

    cat /proc/mounts | grep ossfs

    Uma montagem bem-sucedida retorna uma saída semelhante à seguinte:

    # cat /proc/mounts | grep ossfs
    ossfs /xxx fuse.ossfs ro,relatime,user_id=0,group_id=0,allow_other 0 0
  • Verifique no nível da aplicação.

    Log on to Webshell e execute operações no caminho do sistema de arquivos OSS montado. Se as alterações aparecerem no OSS console, a montagem foi concluída com sucesso.

FAQ

Posso usar o OSS para armazenar logs?

Use Simple Log Service (SLS) ou ApsaraMQ for Kafka para armazenamento persistente de logs.

Não use o OSS para armazenamento persistente de logs. O OSS é projetado para processamento de arquivos em grande escala, como imagens, áudio e vídeo, e para separação de recursos estáticos e dinâmicos em aplicações web.

Solução de problemas

Se você encontrar falhas de montagem, caminhos ausentes ou erros de permissão, siga estas etapas para solucionar o problema.

  1. Verifique se o bucket OSS configurado existe.

    1. Ao implantar a aplicação pelo console, só é possível selecionar buckets OSS existentes que estejam na mesma conta e região.

    2. Ao implantar a aplicação por outros métodos, como API, SDK, a ferramenta saectl ou um plug-in do Jenkins, acesse o OSS console e confirme se o nome do bucket OSS especificado existe na mesma conta e região.

  2. Verifique as permissões do usuário RAM associado ao AccessKey ID e ao AccessKey Secret.

    1. Identifique o usuário RAM associado ao AccessKey ID e ao AccessKey Secret.

    2. Confirme que o usuário RAM tem as permissões necessárias no bucket OSS configurado.

  3. Verifique a Bucket Policy.

    1. Acesse o OSS console. Na página de detalhes do bucket de destino, escolha Permission Control > Bucket Policy no painel de navegação à esquerda.

    2. Verifique se a Bucket Policy bloqueia o acesso do SAE. Especificamente, confirme que os endereços IP públicos do SAE para sua região foram adicionados à lista de permissões, conforme a tabela a seguir.

      Nota

      Para obter os endereços IP públicos específicos do SAE, entre em contato com o suporte técnico pelo grupo DingTalk (ID: 32874633).

      Região

      Endereço IP

      cn-hangzhou

      47,99.xx.xx

      cn-shanghai

      47.101.xx.xx

      cn-beijing

      47,94.xx.xx

      cn-zhangjiakou

      121,89.xx.xx

      cn-wulanchabu

      8.130.xx.xx

      cn-shenzhen

      39.108.xx.xx

      cn-heyuan

      47.121.xx.xx

      cn-guangzhou

      8.134.xx.xx

      cn-chengdu

      47.108.xx.xx

      cn-hongkong

      47.243.xx.xx

      8.210.xx.xx

      ap-southeast-1

      8.219.xx.xx

      eu-central-1

      8.211.xx.xx

      us-west-1

      47,89.xx.xx

      us-east-1

      47.252.xx.xx