Utilitário OCIFS

O OCIFS tem várias restrições de montagem a serem consideradas antes da montagem de um bucket do Object Storage.

Revise as seguintes regras e restrições de montagem:

• Tipos de Arquivo, Atributos e Dimensionamento

• Regras de Nomeação

• Sincronização de Dados

Especifique e configure o método de autenticação baseada em chave de API para montar buckets do Object Storage com o OCIFS.

A autenticação baseada em chave de API é o método de autenticação padrão para OCIFS e pode ser usada em uma instância de computação do OCI ou em qualquer outro sistema. Este método de autenticação requer um SDK do OCI local e um arquivo de configuração da CLI. É possível especificar o arquivo de configuração usando a opção config=file com o comando ocifs. Por padrão, o arquivo de configuração é ~/.oci/config.

$ ocifs --auth=api_key --config=~/my_config bucket-1 mydir

Antes de montar um bucket do serviço Object Storage usando o método de autenticação baseado em chave de API, certifique-se de que o arquivo de configuração da CLI (~/.oci/config) tenha um perfil [DEFAULT] e as entradas especificadas na tabela a seguir.

Para obter mais informações, consulte Arquivo de Configuração da CLI e de SDKs.

Em vez do método de autenticação baseado em chave da API padrão, você pode usar o método de autenticação do controlador de instâncias com o utilitário OCIFS.

Use o método de autenticação do controlador de instâncias para OCIFS somente de uma instância autorizada do Oracle Cloud Infrastructure. Esse método de autenticação permite que instâncias especificadas acessem o Object Storage sem um arquivo de configuração da CLI. A instância então descobre automaticamente informações para autenticação.

A autenticação do controlador de instâncias deve ser usada para montar um bucket do serviço Object Storage em uma instância de computação que foi configurada como um controlador de instâncias.

Por exemplo, para montar um bucket do Object Storage, bucket-1, no diretório mydir usando a autenticação do controlador de instâncias:

$ ocifs --auth=instance_principal bucket-1 mydir

Para usar a autenticação do controlador de instâncias, uma instância de computação deve fazer parte de um grupo dinâmico e uma política deve permitir que o grupo dinâmico gerencie o serviço Object Storage. Você pode usar o verbo manage object-family e o tipo de recurso para definir uma política que permita o gerenciamento de objetos do serviço Object Storage. Para obter mais informações sobre grupos dinâmicos, consulte Gerenciando Grupos Dinâmicos.

Por exemplo, para permitir que uma instância de computação (com o id de instância ocid1.instance.OCID) use a autenticação do controlador de instâncias:

1. Crie um grupo dinâmico dgroup-ocifs com a seguinte regra que corresponda à instância de computação:

   All {instance.id = 'ocid1.instance.OCID'}

2. Crie uma política que permita que esse grupo dinâmico, dgroup-ocifs, gerencie o serviço Object Storage:

   Allow dynamic-group dgroup-ocifs to manage object-family in compartment id ocid1.tenancy.tenancy_ID

Para obter mais informações, consulte Chamando os Serviços em uma Instância.

Em vez do método de autenticação baseado em chave da API padrão, você pode usar o método de autenticação do controlador de recursos com o OCIFS.

Use o método de autenticação do controlador de recursos com o OCIFS somente de uma função autorizada do OCI (Oracle Cloud Infrastructure). Esse método de autenticação permite que a função especificada acesse outro recurso, ou o Object Storage, sem um arquivo de configuração da CLI. Em seguida, a função OCI descobre automaticamente informações para autenticação.

Para usar a autenticação de recursos, uma função do OCI deve fazer parte de um grupo dinâmico, e uma política deve permitir que o grupo dinâmico acesse esse recurso ou o serviço Object Storage. Para obter mais informações sobre grupos dinâmicos, consulte Gerenciando Grupos Dinâmicos.

Para obter informações sobre funções do OCI que acessam outros recursos do OCI, consulte Acessando Outros Recursos do Oracle Cloud Infrastructure.

Para usar o método de autenticação de recursos com o OCIFS, digite --auth=resource_principal ao montar um bucket com o comando ocifs.

Por exemplo, para montar um bucket do serviço Object Storage, bucket-1, no diretório mydir usando a autenticação do controlador de recursos:

$ ocifs --auth=resource_principal bucket-1 mydir

Você pode alterar o diretório de cache do OCIFS com a opção cache=path do comando ocifs.

Por padrão, o OCIFS armazena objetos no cache em ~/.ocifs/. Você pode alterar esse diretório de cache usando a opção cache=path. Esta opção define o diretório de cache para o caminho especificado. O caminho pode ser absoluto ou relativo para o diretório inicial do usuário.

$ ocifs --cache=/var/tmp/ocifs-cache bucket-1 mydir

Você pode manter o cache do OCIFS com a opção cache-keep do comando ocifs, mesmo que o sistema de arquivos do OCIFS esteja desmontado.

A desmontagem do sistema de arquivos do OCIFS remove o diretório de cache do OCIFS, a menos que você monte o sistema de arquivos com a opção cache-keep.

Por exemplo, para montar um bucket do Object Storage, bucket-1, no diretório mydir, e ter o cache preservado após a desmontagem:

$ ocifs --cache-keep bucket-1 mydir

Observações:

• Se você utilizar a opção cache-keep, talvez não consiga montar o sistema de arquivos novamente, a menos que utilize a opção cache-reuse.
• Manter os dados em cache após desmontar o sistema de arquivos pode melhorar o desempenho na próxima vez que você montar o sistema de arquivos. No entanto, o OCIFS não verifica se há discrepâncias entre os dados no cache e os dados reais no bucket do Object Storage.

A opção cache-purge do utilitário OCIFS permite remover dados do cache OCIFS para arquivos que foram fechados por um período especificado.

Por padrão, o cache do OCIFS nunca é expurgado. Os dados de cache são mantidos no diretório de cache enquanto o sistema de arquivos estiver montado. O diretório de cache só é removido quando o sistema de arquivos do OCIFS é desmontado.

Usando a opção cache-purge, você pode especificar a quantidade de tempo que os dados permanecem no cache após o fechamento de um arquivo. É possível usá-lo para preservar espaço em disco, especialmente se os arquivos não forem acessados com frequência. Isto é útil, por exemplo, se você escrever novos arquivos e não acessar os arquivos novamente.

O atraso de expurgação do cache do OCIFS pode ser especificado conforme listado na seguinte tabela:

A opção cache-reuse do utilitário OCIFS permite que um sistema de arquivos OCIFS seja montado, mesmo que haja um diretório de cache existente não vazio.

Por padrão, o OCIFS impede a montagem de um sistema de arquivos se ele tiver um diretório de cache não vazio. Com a opção cache-reuse, você pode remontar o sistema de arquivos e reutilizar o diretório de cache existente, se presente.

Por exemplo, para montar o bucket do serviço Object Storage, bucket-1, no diretório mydir, e reutilizar o diretório de cache existente:

$ ocifs --cache-reuse bucket-1 mydir

Observações:

• Você pode ter um diretório de cache não vazio se o sistema de arquivos foi montado anteriormente com a opção cache-keep, ou se o processo ocifs foi eliminado ou travou.
• A reutilização de um cache existente pode melhorar o desempenho, pois o utilitário OCIFS pode acessar dados que já estão no cache mais rapidamente. No entanto, o uso da opção cache-reuse não é recomendado porque o OCIFS não verifica discrepâncias entre os dados no cache e os dados reais no bucket do Object Storage.

O OCIFS permite que você determine quando ele usa upload em várias partes para fazer upload de arquivos grandes para o Object Storage. Com a opção mpu-threshold=size do OCIFS, você pode especificar o tamanho do arquivo que, acima do qual, inicia o upload em várias partes.

O valor limite de tamanho de upload multiparte padrão é 100 Mebibytes (recomendado).

A tabela a seguir lista os valores de opção mpu-threshold=size suportados.