Advanced ossfs configurations - Object Storage Service: Central de Documentação do Alibaba Cloud

Pré-requisitos

Você já instalou o ossfs 1.0 e configurou o ossfs 1.0.

Formato do comando de montagem

Formato do comando: ossfs bucket_name /tmp/ossfs -o url=http://oss-cn-hangzhou.aliyuncs.com -o sigv4 -o region=cn-hangzhou
Descrição dos parâmetros
- ossfs: Comando ossfs.
- bucket_name: Nome do bucket a ser montado.
- /tmp/ossfs: Diretório local onde o bucket será montado, também conhecido como ponto de montagem.
- -o: Prefixo obrigatório para as opções de montagem.
- url=http://oss-cn-hangzhou.aliyuncs.com: A opção de montagem url especifica o endpoint do bucket de destino. O formato do valor é http://endpoint.
  
  Para encontrar o endpoint do seu bucket, acesse a página Bucket List, selecione o bucket desejado e clique em Overview no painel de navegação à esquerda. A seção Port exibe o endpoint. Este exemplo utiliza um bucket na região China (Hangzhou).
  
  Outros endpoints estão disponíveis para ambientes de rede específicos: oss-cn-hangzhou-internal.aliyuncs.com para acesso a partir de uma instância ECS via rede clássica ou VPC (interno), oss-accelerate.aliyuncs.com para o domínio global de Transfer Acceleration e cn-hangzhou-internal.oss-data-acc.aliyuncs.com para o OSS Accelerator. Selecione um endpoint de acordo com seu ambiente de rede.
- sigv4: Ativa a assinatura V4. Adicione -osigv4 ao comando de montagem. Por padrão, o ossfs usa a assinatura V1. Ao adicionar esta opção, o ossfs envia solicitações ao OSS utilizando o processo de assinatura V4.
- region=cn-hangzhou: ID da região para a solicitação ao bucket do OSS. Adicione -oregion=<region_id> ao montar o bucket. O valor padrão é vazio. Esta opção é obrigatória ao usar assinaturas V4 para especificar a região da solicitação.

Montagem básica

Montagem usando um arquivo de configuração

Crie os diretórios de montagem.

Execute o comando a seguir para criar os diretórios vazios /tmp/ossfs-1 e /tmp/ossfs-2 como pontos de montagem para seus buckets.
```
mkdir /tmp/ossfs-1 /tmp/ossfs-2
```

Exemplo de montagem.

Execute os comandos a seguir para montar bucket-test-1 e bucket-test-2, configurados no arquivo de configuração padrão, nos diretórios /tmp/ossfs-1 e /tmp/ossfs-2, respectivamente.

ossfs bucket-test-1 /tmp/ossfs-1/ -o url=http://oss-cn-hangzhou.aliyuncs.com -o sigv4 -o region=cn-hangzhou
ossfs bucket-test-2 /tmp/ossfs-2/ -o url=http://oss-cn-hangzhou.aliyuncs.com -o sigv4 -o region=cn-hangzhou

Saída esperada:

root@i-xxx:~# ossfs xxx /tmp/ossfs-1 -o url=http://oss-cn-hangzhou.aliyuncs.com -o sigv4 -o region=cn-hangzhou
[NOTICE] OSS signature V1 service will not be available for new uids since March 1st, 2025. It is recommended to mount with OSS signature V4:
    ossfs [oss-bucket] [mount-path] [options] -osigv4 -oregion=[your-region-id]
root@i-xxx:~#
root@i-xxx                :~# df -h /tmp/ossfs-1
Filesystem      Size  Used Avail Use% Mounted on
ossfs            16E     0   16E   0% /tmp/ossfs-1

Montagem usando uma função RAM do ECS

Crie um diretório de montagem.

Execute o comando a seguir para criar o diretório vazio /tmp/ossfs para usar como ponto de montagem do seu bucket.
```
mkdir /tmp/ossfs
```
Exemplo de montagem.

Nota
Ao montar o ossfs usando uma URL de metadados de instância, apenas o modo de acesso normal é suportado. Para mais informações sobre os modos de acesso a metadados, consulte Instance metadata.

Execute o comando a seguir para montar um bucket chamado bucket1 no diretório local /tmp/ossfs.

Nota: Ao montar um bucket usando uma função RAM do ECS, especifique a URL de metadados da instância com o parâmetro ram_role. O endereço IP 100.100.100.200 é o padrão para o serviço de instance metadata do Alibaba Cloud ECS e não deve ser alterado. Substitua EcsRamRoleOssTest pelo nome da função anexada à sua instância ECS. Não altere nenhuma outra informação.
```
ossfs bucket1 /tmp/ossfs -o url=http://oss-cn-hangzhou.aliyuncs.com -o ram_role=http://100.100.100.200/latest/meta-data/ram/security-credentials/EcsRamRoleOssTest -o sigv4 -o region=cn-hangzhou
```

Saída esperada:

root@xxx         xxx:~# ossfs  xxx  /tmp/ossfs -o url=http://oss-cn-hangzhou.aliyuncs.com -o ram role=http://100.100.100.200/latest/meta-data/ram/security-credentials/xxx  -o sigv4 -o region=cn-hangzhou
[NOTICE] OSS signature V1 service will not be available for new uids since March 1st, 2025. It is recommended to mount with OSS signature V4:
        ossfs [oss-bucket] [mount-path] [options] -osigv4 -oregion=[your-region-id]
root@xxx         xxx:~#
root@xxx         xxx:~# df -h /tmp/ossfs
Filesystem  Size  Used  Avail Use% Mounted on
ossfs       16E   0     16E   0%   /tmp/ossfs

Montagem em cenários específicos

É possível montar um diretório específico ou adicionar opções de montagem. Para obter uma lista de opções, consulte mount options. Nota: Antes de executar o comando de montagem, certifique-se de que o diretório de montagem local esteja vazio.

Montagem de um diretório específico

Execute o comando a seguir para montar o diretório folder do bucket bucket-ossfs-test no diretório local /tmp/ossfs-folder.

ossfs bucket-ossfs-test:/folder /tmp/ossfs-folder -o url=http://oss-cn-hangzhou.aliyuncs.com -o sigv4 -o region=cn-hangzhou

Montagem usando um arquivo de configuração especificado

Opção de montagem: Utilize a opção passwd_file para especificar o caminho de um arquivo de configuração do ossfs 1.0 que não seja o padrão. Defina as permissões do arquivo como 600.
Exemplo de montagem

Execute o comando a seguir para montar o bucket-test-3, configurado no arquivo de configuração especificado, no diretório local /tmp/ossfs-3.
```
ossfs bucket-test-3 /tmp/ossfs-3 -o url=http://oss-cn-hangzhou.aliyuncs.com -o passwd_file=/etc/passwd-ossfs-3 -o sigv4 -o region=cn-hangzhou
```

Ativação de logs de depuração durante a montagem

Opção de montagem: A opção dbglevel define o nível de log. Os seguintes níveis são suportados: critical, error, warn, info e debug. O valor padrão é critical. Por padrão, os logs são salvos em /var/log/messages em sistemas CentOS e em /var/log/syslog em sistemas Ubuntu. Você também pode usar a opção logfile para especificar um caminho personalizado para o arquivo de log.
Exemplo de montagem 1

Execute o comando a seguir para montar o bucket-ossfs-test-1 no diretório local /tmp/ossfs-1. Neste comando, a opção -d ativa o log de depuração do libfuse, e a opção dbglevel define o nível de log como debug.
```
ossfs bucket-ossfs-test-1 /tmp/ossfs-1 -d -o dbglevel=debug -o sigv4 -o region=cn-hangzhou
```
Exemplo de montagem 2

Execute o comando a seguir para montar o bucket-ossfs-test-2 no diretório local /tmp/ossfs-2. O nível de log é definido como debug e o log de depuração do libfuse está ativado. As mensagens de log são impressas no terminal em primeiro plano usando a opção -f.
```
ossfs bucket-ossfs-test-2 /tmp/ossfs-2 -d -o dbglevel=debug -f -o sigv4 -o region=cn-hangzhou
```

Configuração de permissões de acesso durante a montagem

Por padrão, apenas o usuário que executa o comando de montagem (o proprietário) pode acessar o diretório montado. Para permitir que outros usuários acessem o ponto de montagem, configure os parâmetros descritos abaixo ao montar o bucket.

Parâmetro	Descrição
allow_other	Permite que todos os usuários acessem o próprio diretório do ponto de montagem, mas não os arquivos dentro dele. As permissões para arquivos devem ser definidas separadamente. Use o comando `chmod` para alterar as permissões de arquivos individuais. Para aplicar permissões uniformes a todos os arquivos, configure a opção `umask`.
uid	UID do usuário proprietário do diretório.
gid	GID do grupo proprietário do diretório.
umask	Define a máscara de permissão para arquivos e diretórios no ponto de montagem. Por exemplo, para definir as permissões no ponto de montagem como 770, adicione -o umask=007. Para definir as permissões como 700, adicione -o umask=077.

Exemplo de montagem 1

Execute o comando a seguir para montar o bucket_name no diretório local mount_point e use a opção allow_other para conceder acesso a todos os usuários. Isso define as permissões do diretório de montagem como 777.
```
ossfs bucket_name mount_point -o url=endpoint -o allow_other -o sigv4 -o region=cn-hangzhou
```
Exemplo de montagem 2

Execute o comando a seguir para montar o bucket_name no diretório local mount_point e use a opção umask para definir as permissões do diretório de montagem e dos arquivos contidos nele como 770. Isso permite acesso apenas para usuários do mesmo grupo.
```
ossfs bucket_name mount_point -o url=endpoint -o umask=007 -o sigv4 -o region=cn-hangzhou
```
Exemplo de montagem 3
1. Execute o comando a seguir para obter o UID, GID e grupos de um usuário específico. O usuário www é usado neste exemplo.
```
id www
```
  Saída esperada do comando:
```
root@iZbp1325rf1sja6ye4kbm2Z:~# id www
uid=xxx(www) gid=xxx(www) groups=xxx(www)
```
2. Execute o comando a seguir para montar o bucket_name no diretório local mount_point e use as opções uid e gid para especificar o usuário e o grupo. Essa configuração concede acesso apenas aos usuários do mesmo grupo e define as permissões como 770. O uid e o gid são 1000 neste exemplo. Antes de executar o comando de montagem, substitua esses valores pelo uid e gid do usuário de destino.
```
ossfs bucket_name mount_point -o url=endpoint -o allow_other -o uid=1000 -o gid=1000 -o umask=007 -o sigv4 -o region=cn-hangzhou
```

Dicas úteis

Automatic mount on startup

Um bucket montado manualmente não é remontado automaticamente após a reinicialização do sistema. Para ativar a montagem automática na inicialização, siga estas etapas. Antes de ativar a montagem automática, certifique-se de que a montagem manual funcione corretamente. Isso evita falhas na inicialização do ECS. O método a seguir ativa a montagem automática após a configuração do ossfs com um par de AccessKey.

Grave o nome do bucket, AccessKey ID, AccessKey secret e outras informações no arquivo /etc/passwd-ossfs e defina as permissões do arquivo como 640.

Para mais informações sobre as etapas de configuração, consulte Configure ossfs 1.0.

Configure a montagem automática na inicialização.

Nota

Os exemplos a seguir mostram como ativar a montagem automática na inicialização para distribuições e versões comuns. Para outras distribuições e versões, consulte a documentação da sua distribuição.

Mount with fstab

Adicione a seguinte linha ao arquivo /etc/fstab:

ossfs#bucket_name mount_point fuse _netdev,url=url,allow_other 0 0

A tabela a seguir descreve os parâmetros.

Parâmetro	Descrição
bucket_name	Nome do bucket a ser montado. Substitua `bucket_name` pelo nome do seu bucket.
mount_point	Diretório de montagem local. Substitua `mount_point` pelo caminho do seu diretório de montagem local.
url=url	Endpoint do bucket de destino.
0 0	Opções do sistema de arquivos.

Salve o arquivo /etc/fstab. Execute o comando mount -a -t fuse. Se nenhum erro for relatado, a configuração está correta.
Após concluir a etapa anterior, a montagem automática estará ativada no Ubuntu 14.04. Para o CentOS 6.5, execute também o seguinte comando:
```
chkconfig netfs on
```

Mount with a startup script

Crie um arquivo chamado ossfs no diretório /etc/init.d/ e copie o conteúdo a seguir para o arquivo. Substitua os valores no comando de montagem pelas informações do seu bucket de destino.

#! /bin/bash
#
# ossfs      Automount Aliyun OSS Bucket in the specified direcotry.
#
# chkconfig: 2345 90 10
# description: Activates/Deactivates ossfs configured to start at boot time.
ossfs your_bucket your_mountpoint -ourl=your_url -oallow_other

Conceda permissões de execução ao novo script ossfs:
```
chmod a+x /etc/init.d/ossfs
```
Após a execução do comando, tente executar o script. Se o conteúdo do script estiver correto, o bucket do OSS será montado no diretório especificado.
Configure o script ossfs para iniciar na inicialização como um serviço:
```
chkconfig ossfs on
```
Após realizar as etapas anteriores, o ossfs será montado automaticamente na inicialização.

Importante

O chkconfig não reinicia automaticamente o ossfs se ele encerrar inesperadamente. Ele garante apenas que o ossfs inicie automaticamente na inicialização.

Desmontar um bucket

Para desmontar um bucket, execute o comando a seguir. Por exemplo, para desmontar o sistema de arquivos montado em /tmp/ossfs:

umount /tmp/ossfs

FAQ

Para montar um bucket do OSS em um sistema Windows, utilize o Cloud Storage Gateway (CSG). Para mais informações, consulte Use a file gateway in the Alibaba Cloud console e Access an SMB shared directory.
A montagem de um bucket do OSS a partir de uma instância ECS via endpoint interno não gera taxas de tráfego. Para mais informações sobre taxas de tráfego, consulte Traffic fees.
Se sua instância ECS e o bucket do OSS estiverem em regiões diferentes e você precisar montar o bucket entre regiões, garanta a conectividade de rede. É possível usar diretamente um endpoint público para montar o bucket. Alternativamente, você pode ative uma instância ECS para acessar um serviço OSS em outra região por meio de uma rede privada.
Caso precise criar um site IIS usando o Cloud Storage Gateway e utilizar o OSS para armazenamento de dados, consulte Build an IIS website by using Alibaba Cloud Storage Gateway.
Para montar um bucket do OSS em um sistema operacional Windows, consulte Rclone.
Para mais informações sobre problemas relacionados a montagem e permissões, consulte FAQ.