{"id":13538915,"url":"https://github.com/oracle/zfssa-csi-driver","last_synced_at":"2025-08-11T19:11:07.975Z","repository":{"id":45712039,"uuid":"399297544","full_name":"oracle/zfssa-csi-driver","owner":"oracle","description":"Kubernetes Container Storage Interface (CSI) plug-in for Oracle ZFS Storage Appliance.","archived":false,"fork":false,"pushed_at":"2024-07-02T15:12:58.000Z","size":205,"stargazers_count":14,"open_issues_count":5,"forks_count":6,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-04-10T16:12:05.151Z","etag":null,"topics":["csi-driver","csi-plugin","kubernetes","oracle","zfssa"],"latest_commit_sha":null,"homepage":"","language":"Go","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.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-08-24T01:29:31.000Z","updated_at":"2025-04-04T04:32:35.000Z","dependencies_parsed_at":"2022-09-04T00:30:51.176Z","dependency_job_id":"f5a3f504-b004-46d9-8d13-a1b7702cfce8","html_url":"https://github.com/oracle/zfssa-csi-driver","commit_stats":{"total_commits":14,"total_committers":3,"mean_commits":4.666666666666667,"dds":0.5714285714285714,"last_synced_commit":"4576b6ff54be638ecdea15dff73a1bbb83236f52"},"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/oracle/zfssa-csi-driver","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle%2Fzfssa-csi-driver","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle%2Fzfssa-csi-driver/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle%2Fzfssa-csi-driver/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle%2Fzfssa-csi-driver/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oracle","download_url":"https://codeload.github.com/oracle/zfssa-csi-driver/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle%2Fzfssa-csi-driver/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269940350,"owners_count":24500460,"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-08-11T02:00:10.019Z","response_time":75,"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":["csi-driver","csi-plugin","kubernetes","oracle","zfssa"],"created_at":"2024-08-01T09:01:17.647Z","updated_at":"2025-08-11T19:11:07.930Z","avatar_url":"https://github.com/oracle.png","language":"Go","funding_links":[],"categories":["🏗相关开源项目"],"sub_categories":["Oracle"],"readme":"# About zfssa-csi-driver \n\nThis plugin supports Oracle ZFS Storage Appliance\nas a backend for block storage (iSCSI volumes) and file storage (NFS).\n\n| CSI Plugin Version | Supported CSI Versions | Supported Kubernetes Versions | Persistence | Supported Access Modes | Dynamic Provisioning | Raw Block Support |\n|--------------------|------------------------|-------------------------------| --- | --- | --- | --- |\n| v1.0.0             | v1.0+                  | v1.17.X+                      | Persistent | Read/Write Once (for Block), ReadWriteMany (for File) | Yes | Yes |\n| v1.1.0             | v1.6.0                 | v1.27.3+                      | Persistent | Read/Write Once (for Block), ReadWriteMany (for File) | Yes | Yes |\n\n\n## Requirements\n\n* Kubernetes v1.27 or above (version may work on prior Kubernetes versions)\n* A Container runtime implementing the Kubernetes Container Runtime Interface.\n* An Oracle ZFS Storage Appliance running Appliance Kit Version 8.8 or above. This plugin may work with previous \n  versions but it is not tested with them. It is possible to use this \n  driver with the [Oracle ZFS Storage Marketplace Image on OCI](https://cloudmarketplace.oracle.com/marketplace/en_US/listing/122033460)\n* Access to both a management path and a data path for the target Oracle \n  ZFS Storage Appliance (or simulator). The management and data path\n  can be the same address.\n* A suitable container image build environment (podman or docker are accounted\n  for in the makefile)\n\n## Unsupported Functionality\nOracle ZFS Storage Constainer Storage Interface (CSI) driver does not support the following functionality:\n* Volume Cloning\n\n## Building\n\nUse and enhance the Makefile in the root directory and release-tools/build.make.\n\nBuild the driver:\n```\nmake build\n```\nDepending on the golang installation, there may be dependencies identified by the build, install\nthese and retry the build.\n\nThe parent image for the container is container-registry.oracle.com/os/oraclelinux:7-slim, refer\nto [container-registry.oracle.com](https://container-registry.oracle.com/) for more information.\nThe parent image can also be obtained from ghcr.io/oracle/oraclelinux and docker.io/library/oraclelinux.\n\nThe container build can use the \"CONTAINER_PROXY\" environment variable if the build\nis being done from behind a firewall:\n```\nexport DOCKER_PROXY=\u003cproxy\u003e\nmake container\n```\nTag and push the resulting container image to a container registry available to the\nKubernetes cluster where it will be deployed or use the 'make push' option.\n\nThe push target depends on the branch or tag name:\n\n* the branch must be prefixed with 'zfssa-' and can be pushed once\n* a branch with a suffix of '-canary' will be a canary image and can be pushed\nrepeatedly\n\nSpecify the REPOSITORY_NAME on the make command (login prior to pushing):\n```\nmake push REGISTRY_NAME=\u003cyour registry base\u003e\n```\n\n## Installation\n\nSee [INSTALLATION](./INSTALLATION.md) for details.\n\n## Testing\n\nFor information about testing the driver, see [TEST](./TEST.md).\n\n## Examples\n\nExample usage of this driver can be found in the ./examples\ndirectory.\n\nThe examples below use the image _container-registry.oracle.com/os/oraclelinux:7-slim_\nwhen they create a container where a persistent volume(s) is attached and mounted.\n\nThis set uses dynamic volume creation.\n* [NFS](./examples/nfs/README.md) - illustrates NFS volume usage\nfrom a simple container.\n* [Block](./examples/block/README.md) - illustrates block volume\nusage from a simple container.\n* [NFS multi deployment](./examples/nfs-multi) - illustrates the use\nof Helm to build several volumes and optionally build a pod to consume them.\n\nThis next set uses existing shares on the target appliance:\n* [Existing NFS](./examples/nfs-pv/README.md) - illustrates NFS volume usage\nfrom a simple container of an existing NFS filesystem share.\n* [Existing Block](./examples/block-pv/README.md) - illustrates block volume\nusage from a simple container of an existing iSCSI LUN.\n\nThis set exercises dynamic volume creation followed by expanding the volume capacity.\n* [NFS Volume Expansion](./examples/nfs-exp/README.md) - illustrates an expansion of an NFS volume.\n\nThis set exercises dynamic volume creation (restoring from a volume snapshot) followed by creating a snapshot of the volume.\n* [NFS Volume Snapshot](./examples/nfs-vsc/README.md) - illustrates a snapshot creation of an NFS volume.\n* [Block Volume Snapshot](./examples/block-vsc/README.md) - illustrates a snapshot creation of a block volume.\n\n## Help\n\nRefer to the documentation links and examples for more information on\nthis driver.\n\n## Security\n\nPlease consult the [security guide](./SECURITY.md) for our responsible security vulnerability disclosure process\n\n## Contributing\n\nSee [CONTRIBUTING](./CONTRIBUTING.md) for details.\n\n## License\n\nCopyright (c) 2021 Oracle and/or its affiliates.\n\nReleased under the Universal Permissive License v1.0 as shown at\n\u003chttps://oss.oracle.com/licenses/upl/\u003e.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foracle%2Fzfssa-csi-driver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foracle%2Fzfssa-csi-driver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foracle%2Fzfssa-csi-driver/lists"}