{"id":18802269,"url":"https://github.com/oracle-quickstart/oci-lustre","last_synced_at":"2025-10-05T19:59:34.906Z","repository":{"id":106380493,"uuid":"171955686","full_name":"oracle-quickstart/oci-lustre","owner":"oracle-quickstart","description":"Terraform template to deploy the DDN Lustre distributed file system on OCI","archived":false,"fork":false,"pushed_at":"2021-10-08T15:58:51.000Z","size":15544,"stargazers_count":6,"open_issues_count":0,"forks_count":6,"subscribers_count":9,"default_branch":"master","last_synced_at":"2025-04-20T18:41:48.208Z","etag":null,"topics":["cloud","lustre","oci","oracle","oracle-led","terraform"],"latest_commit_sha":null,"homepage":"","language":"HCL","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"upl-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oracle-quickstart.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-02-21T22:33:48.000Z","updated_at":"2024-02-02T13:49:07.000Z","dependencies_parsed_at":null,"dependency_job_id":"d736fe58-f1bb-47c8-b402-4ab42f22c1bb","html_url":"https://github.com/oracle-quickstart/oci-lustre","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/oracle-quickstart/oci-lustre","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle-quickstart%2Foci-lustre","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle-quickstart%2Foci-lustre/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle-quickstart%2Foci-lustre/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle-quickstart%2Foci-lustre/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oracle-quickstart","download_url":"https://codeload.github.com/oracle-quickstart/oci-lustre/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle-quickstart%2Foci-lustre/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278510913,"owners_count":25998997,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-05T02:00:06.059Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cloud","lustre","oci","oracle","oracle-led","terraform"],"created_at":"2024-11-07T22:27:14.737Z","updated_at":"2025-10-05T19:59:34.870Z","avatar_url":"https://github.com/oracle-quickstart.png","language":"HCL","funding_links":[],"categories":[],"sub_categories":[],"readme":"# oci-lustre\n\nThis Terraform template deploys [Lustre](http://lustre.org/) on [Oracle Cloud Infrastructure (OCI)](https://cloud.oracle.com/en_US/cloud-infrastructure) on Bare metal or VM compute shapes (Standard or DenseIO) using local NVMe SSDs (for scratch file system) or OCI Block Volume Storage (for persistent file system).  Bare metal compute shapes with two physical NICs (2x25Gbps or 2x50Gbps)  are recommended for file servers to get maximum IO throughput performance.   \n\nThe template deploys MGS, MGS and OSS on separate compute nodes. It supports multiple MDS and OSS nodes.  \n\nOCI offers many compute shapes and storage offerings, reach out for OCI HPC team member (pinkesh.valdria@oracle.com) for guidance on which OCI compute shapes, storage to use and architecting Lustre on OCI for optimal performance.  \n\nFor details of the architecture, see [_Deploy a scalable, distributed file system using Lustre_](https://docs.oracle.com/en/solutions/deploy-lustre-fs/index.html)\n \n## Deploy Using Oracle Resource Manager\n\n1. Click [![Deploy to Oracle Cloud](https://oci-resourcemanager-plugin.plugins.oci.oraclecloud.com/latest/deploy-to-oracle-cloud.svg)](https://cloud.oracle.com/resourcemanager/stacks/create?region=home\u0026zipUrl=https://github.com/oracle-quickstart/oci-lustre/releases/latest/download/oci-lustre-stack-latest.zip)\n\n    If you aren't already signed in, when prompted, enter the tenancy and user credentials.\n\n2. Review and accept the terms and conditions.\n\n3. Select the region where you want to deploy the stack.\n\n4. Follow the on-screen prompts and instructions to create the stack.\n\n5. After creating the stack, click **Terraform Actions**, and select **Plan**.\n\n6. Wait for the job to be completed, and review the plan.\n\n    To make any changes, return to the Stack Details page, click **Edit Stack**, and make the required changes. Then, run the **Plan** action again.\n\n7. If no further changes are necessary, return to the Stack Details page, click **Terraform Actions**, and select **Apply**. \n\n## Deploy Using the Terraform CLI\n\n### Clone the Repository\nNow, you'll want a local copy of this repo.  You can make that with the commands:\n\n    git clone https://github.com/oracle-quickstart/oci-lustre.git\n    cd oci-lustre/\n    ls\n\n### Prerequisites\nFirst off, you'll need to do some pre-deploy setup.  That's all detailed [here](https://github.com/cloud-partners/oci-prerequisites).\n\nSecondly, create a `terraform.tfvars` file and populate with the following information:\n\n```\n# Authentication\ntenancy_ocid         = \"\u003ctenancy_ocid\u003e\"\nuser_ocid            = \"\u003cuser_ocid\u003e\"\nfingerprint          = \"\u003cfinger_print\u003e\"\nprivate_key_path     = \"\u003cpem_private_key_path\u003e\"\n\n# Region\nregion = \"\u003coci_region\u003e\"\n\n# Compartment\ncompartment_ocid = \"\u003ccompartment_ocid\u003e\"\n\n# Availablity Domain \nad_number = \u003cad_number\u003e # for example 0 for the first AD in the region.\n\n# or...\nad_name = \u003cad_name\u003e   # for example \"GrCH:US-ASHBURN-AD-1\"\n\n````    \n\n## Update variables.tf file (optional)\nThis is optional, but you can update the variables.tf to change compute shapes, block volumes, etc. \n\n### Create the Resources\nRun the following commands:\n\n    terraform init\n    terraform plan\n    terraform apply\n\n### Destroy the Deployment\nWhen you no longer need the deployment, you can run this command to destroy the resources:\n\n    terraform destroy\n\n## Deploy as a Module\nIt's possible to utilize this repository as remote module, providing the necessary inputs:\n\n```\nmodule \"oci-lustre\" {\n  source                        = \"github.com/oracle-quickstart/oci-lustre\"\n  tenancy_ocid                  = \"\u003ctenancy_ocid\u003e\"\n  user_ocid                     = \"\u003cuser_ocid\u003e\"\n  fingerprint                   = \"\u003cfinger_print\u003e\"\n  private_key_path              = \"\u003cprivate_key_path\u003e\"\n  region                        = \"\u003coci_region\u003e\"\n  compartment_ocid              = \"\u003ccompartment_ocid\u003e\"\n  ad_number                     = 0\n  use_existing_vcn              = true # You can inject your own VCN and subnets \n  vcn_id                        = oci_core_virtual_network.my_vcn.id\n  bastion_subnet_id             = oci_core_subnet.my_pub_subnet.id\n  storage_subnet_id             = oci_core_subnet.my_priv_storage_subnet.id\n  fs_subnet_id                  = oci_core_subnet.my_priv_fs_subnet.id\n}\n```\n\nFor the module's usage check the code examples below:\n* [Usage of the existing network](examples/remote-module-existing-network) deploys the configuration with the VCN and Subnets provisioned outside of the module and injected into module\n* [Network provisioned by the module](examples/remote-module-no-existing-network) deploys the configuration including VCN and Subnets.\n\n## Architecture Diagram\n\n![](./images/lustre-oci.png)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foracle-quickstart%2Foci-lustre","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foracle-quickstart%2Foci-lustre","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foracle-quickstart%2Foci-lustre/lists"}