Documentação do Oracle Cloud Infrastructure

Criando um Sistema de Arquivos

No Private Cloud Appliance, você pode criar um sistema de arquivos compartilhado usando o serviço File Storage.

(Opcional) Para criar um sistema de arquivos com valores específicos para os atributos a seguir, primeiro configure os atributos conforme descrito em Usando Tags de Recursos para Estender a Funcionalidade (IAM no Appliance). Em seguida, utilize as informações a seguir ao criar o sistema de arquivos.

  • Cota

    O valor padrão de quota é 0, o que significa que nenhuma cota está definida. Uma cota que você define inclui os dados no sistema de arquivos e todos os instantâneos criados no sistema de arquivos. Você pode especificar um valor de cota em gigabytes de 0 a 8000000 (8 petabytes). Qualquer parte fracionária do valor de gigabyte é arredondada para o próximo megabyte maior. A cota do sistema de arquivos pode ser alterada com o comando update do sistema de arquivos.

    Para aplicar uma cota, durante a criação do sistema de arquivos, atribua esta tag definida:

    • Namespace de tag: OraclePCA
    • Nome da tag: quota
    • Valor: <quota value in gigabytes>

  • Tamanho do registro do banco de dados

    O tamanho do registro do banco de dados padrão é 131072 bytes. Você pode especificar um dos seguintes valores (em bytes): 512, 1024, 2048, 4096, 8192, 16384, 32768, 65536, 131072, 262144, 524288, 1048576. O tamanho do registro só pode ser definido quando o sistema de arquivos é criado. Não é possível definir ou alterar este valor de propriedade posteriormente.

  • Para usar um valor não padrão, durante a criação do sistema de arquivos, atribua esta tag definida:

    • Namespace de tag: OraclePCA
    • Nome da tag: databaseRecordSize
    • Value (select one): 512, 1024, 2048, 4096, 8192, 16384, 32768, 65536, 131072, 262144, 524288, 1048576

  • Pool de armazenamento de apoio

    Por padrão, o armazenamento de apoio de um sistema de arquivos é o pool padrão do ZFS Storage Appliance anexado, especificado como PCA_POOL. Você pode especificar PCA_POOL_HIGH para indicar que deseja usar um pool de alto desempenho para o armazenamento de apoio. Antes de especificar PCA_POOL_HIGH, verifique se há um pool de alto desempenho disponível. Essa propriedade só pode ser definida quando o sistema de arquivos é criado. Não é possível definir ou alterar este valor de propriedade posteriormente.

    Para usar um valor não padrão, durante a criação do sistema de arquivos, atribua esta tag definida:

    • Namespace de tag: OraclePCA
    • Nome da tag: databaseRecordSize
    • Value (select one): PCA_POOL (default) ou PCA_POOL_HIGH

Evite inserir informações confidenciais em nomes e tags.

    1. No menu de navegação UI do Compute Web, selecione File Storage e, em seguida, Sistemas de Arquivos.

    2. Certifique-se de que o compartimento correto esteja selecionado no menu suspenso de compartimentos acima da lista de sistemas de arquivos. O sistema de arquivos e o ponto de acesso NFS devem estar no mesmo compartimento e no mesmo pool de armazenamento de apoio quando você cria uma exportação.

    3. Selecione Criar Sistema de Arquivos.

    4. Na caixa de diálogo Criar Sistema de Arquivos, especifique as seguintes informações:

      • Nome: Não precisa ser exclusivo. Um Oracle Cloud Identifier (OCID) identifica exclusivamente o sistema de arquivos. Evite digitar informações confidenciais.

      • Criar no Compartimento: Selecione o compartimento no qual o sistema de arquivos é criado.

      • Tagging: (Opcional) Adicione tags definidas ou de formato livre para esse recurso, conforme descrito em Adicionando Tags na Criação de Recursos. As tags também podem ser aplicadas posteriormente.

        Se o namespace de tag OraclePCA e as definições de chave de tag OraclePCA para sistemas de arquivos estiverem configurados na sua tenancy do OCI (consulte Usando Tags de Recurso para Estender a Funcionalidade (IAM no Appliance)), você poderá especificar o Namespace de Tag OraclePCA, selecionar uma chave e um valor. Seu sistema de arquivos é criado com o atributo aplicável. O namespace de tag OraclePCA não pode ser adicionado posteriormente.

    5. Selecione Criar Sistema de Arquivos.

      O sistema de arquivos é criado.

      Em seguida, crie um arquivo de exportação para o sistema. Consulte Creating an Export for a File System.

  • Use o comando oci fs file-system create e os parâmetros necessários para criar um novo sistema de arquivos no compartimento e domínio de disponibilidade especificados.

    oci fs file-system create --availability-domain <availability_domain_name>  --compartment-id <compartment_id> --display-name <fs_display_name>  [OPTIONS]

    Para obter uma lista completa de comandos, flags e opções da CLI, consulte a Referência da Linha de Comandos.

    Procedimento

    1. Reúna as informações necessárias para executar o comando:

      • Nome do Domínio de Disponibilidade (oci iam availability-domain list)

      • OCID do Compartimento (oci iam compartment list)

      • Nome do sistema de arquivos: o nome de exibição que você deseja atribuir a este sistema de arquivos

    2. Para usar valores não padrão para a cota, o tamanho do registro do banco de dados ou o pool de armazenamento de backend, especifique as tags apropriadas para definir os valores desses atributos. Consulte Adicionando Tags na Criação de Recursos.

      Consulte a etapa a seguir para obter um exemplo de como definir esses valores.

    3. Execute o comando create file system.

      Exemplo:

      oci fs file-system create --availability-domain AD-1 --compartment-id ocid1.compartment.unique_ID --display-name MyFileSystem

{
  "data": {
    "availability-domain": "AD-1",
    "compartment-id": "ocid1.compartment.unique_ID",
    "defined-tags": {
      "Oracle-Tags": {
        "CreatedBy": "pca_user",
        "CreatedOn": "2024-07-05T13:15:11.19Z"
      }
    },
    "display-name": "MyFileSystem",
    "freeform-tags": {},
    "id": "ocid1.filesystem.unique_ID",
    "is-clone-parent": false,
    "is-hydrated": true,
    "is-targetable": null,
    "kms-key-id": "",
    "lifecycle-details": "",
    "lifecycle-state": "CREATING",
    "metered-bytes": 0,
    "source-details": {
      "parent-file-system-id": "",
      "source-snapshot-id": ""
    },
    "time-created": "2024-07-05T13:15:11.234434+00:00"
  },
  "etag": "58dec47e-4732-4730-9e18-6b5db1ac30d6"
}

      Exemplo de uso de tags definidas para definir propriedades adicionais:

      Para definir uma cota para o sistema de arquivos, alterar o tamanho padrão do registro do banco de dados ou especificar um pool de alto desempenho para o armazenamento de backup do sistema de arquivos, use tags definidas OraclePCA, conforme mostrado no exemplo a seguir.

      oci fs file-system create --availability-domain AD-1 --compartment-id ocid1.compartment.unique_ID  --display-name myfilesystem --defined-tags '{"OraclePCA":{"quota":100000,"databaseRecordSize":8192,"poolName":"PCA_POOL_HIGH"}}'

      Como alternativa, você pode especificar essas propriedades em um arquivo JSON.

      {
  "OraclePCA": {
    "quota": 100000,
    "databaseRecordSize": 8192,
    "poolName": "PCA_POOL_HIGH"
  }
}

      Em seguida, especifique o arquivo como argumento da opção --defined-tags.

      --defined-tags file://./fs_options.json

    4. Em seguida, crie um arquivo de exportação para o sistema. Consulte Creating an Export for a File System.

  • Use a operação CreateFileSystem para criar um novo sistema de arquivos no compartimento e domínio de disponibilidade especificados.

    Para obter informações sobre como usar a API e assinar solicitações, consulte APIs REST e Credenciais de Segurança. Para obter informações sobre SDKs, consulte Kits de Desenvolvimento de Software e Interface de Linha de Comando.