{"id":27093463,"url":"https://github.com/mgruszkiewicz/backblaze-operator","last_synced_at":"2025-12-15T02:46:19.635Z","repository":{"id":200829381,"uuid":"701896319","full_name":"mgruszkiewicz/backblaze-operator","owner":"mgruszkiewicz","description":"Backblaze B2 operator for Kubernetes","archived":false,"fork":false,"pushed_at":"2025-03-16T09:57:33.000Z","size":157,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-31T04:33:08.454Z","etag":null,"topics":["backblaze","backblaze-b2","golang","kubernetes","kubernetes-operator","operator-sdk"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mgruszkiewicz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2023-10-07T22:15:29.000Z","updated_at":"2025-03-16T09:50:19.000Z","dependencies_parsed_at":null,"dependency_job_id":"a5e1b3af-871d-42c8-b6bb-911c3e1aa5c1","html_url":"https://github.com/mgruszkiewicz/backblaze-operator","commit_stats":null,"previous_names":["ihyoudou/backblaze-operator","mgruszkiewicz/backblaze-operator"],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mgruszkiewicz%2Fbackblaze-operator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mgruszkiewicz%2Fbackblaze-operator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mgruszkiewicz%2Fbackblaze-operator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mgruszkiewicz%2Fbackblaze-operator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mgruszkiewicz","download_url":"https://codeload.github.com/mgruszkiewicz/backblaze-operator/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247451659,"owners_count":20940944,"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","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":["backblaze","backblaze-b2","golang","kubernetes","kubernetes-operator","operator-sdk"],"created_at":"2025-04-06T08:17:24.474Z","updated_at":"2025-12-15T02:46:19.571Z","avatar_url":"https://github.com/mgruszkiewicz.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Backblaze Operator\nUnofficial Backblaze B2 Operator for Kubernetes\n\n## Description\nThis project is a unofficial Backblaze B2 Operator for Kubernetes. It supports:\n- Creating and deleting B2 bucket\n- Set and update bucket ACL\n- Setting lifecycle policy on bucket\n- Creating and writing application keys to secret\n\n\n## Getting Started\nYou’ll need a Kubernetes cluster to run against and Backblaze account.\n\nCreate a key on Backblaze B2 to use for operator - you can create Master Application Key or regular Application Key (with permissions to create new keys).\n* to create Master Application Key, go to Account -\u003e Application Keys -\u003e Generate New Master Application Key\n* to create Application Key, you will need to use [b2 CLI tool](https://www.backblaze.com/docs/cloud-storage-command-line-tools) (and you will need to create master key anyway).\n```\n$ b2 key create KEY-NAME writeKeys,deleteKeys,listBuckets,listAllBucketNames,readBuckets,writeBuckets,deleteBuckets\n```\nThe output will be space-seperated `application-id application-key`\n\n### Running on the cluster\n\n**Using Helm**\n\nTo install a release named `b2operator` run:\n```bash\nhelm upgrade --install backblaze-operator backblaze-operator \\\n  --set credentials.b2ApplicationId=\"your-application-id\" \\\n  --set credentials.b2ApplicationKey=\"your-application-key\" \\\n  --set credentials.b2Region=\"us-west-004\" \\\n  --namespace backblaze-operator --create-namespace \\\n  --repo https://mgruszkiewicz.github.io/helm-charts\n```\nReplace `your-application-id`, `your-application-key` and `us-west-004` with details that match your account.\nYou can view all available values in [helm-charts repo](https://github.com/mgruszkiewicz/helm-charts/tree/main/charts/backblaze-operator).\n\n### Example CRD Usage: Creating a B2 bucket\n\nCreating bucket with lifecycle policies on prefix `/` and `/logs`. Lifecycle policies are optional.\n\n```yaml\napiVersion: b2.issei.space/v1alpha2\nkind: Bucket\nmetadata:\n  name: my-b2-bucket\nspec:\n  atProvider:\n    acl: private\n    bucketLifecycle:\n      - fileNamePrefix: \"/\"\n        daysFromUploadingToHiding: 2\n        daysFromHidingToDeleting: 3\n      - fileNamePrefix: \"logs\"\n        daysFromUploadingToHiding: 5\n        daysFromHidingToDeleting: 7\n```\n\n### Example CRD Usage: Creating a application key\n\nCreating keys with default permissions that will have access to bucket `my-b2-bucket` and will be saved to `new-key` secret in namespace `default`\n```yaml\napiVersion: b2.issei.space/v1alpha2\nkind: Key\nmetadata:\n  name: my-b2-key\nspec:\n  atProvider:\n    bucketName: my-b2-bucket\n    capabilities:\n      - deleteFiles\n      - listAllBucketNames\n      - listBuckets\n      - listFiles\n      - readBucketEncryption\n      - readBucketReplications\n      - readBuckets\n      - readFiles\n      - shareFiles\n      - writeBucketEncryption\n      - writeBucketReplications\n      - writeFiles\n  writeConnectionSecretToRef:\n      name: new-key\n      namespace: default\n```\nThe secret will contain `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `bucketName`, `endpoint`, `keyName`.\n\n### Learn more\nYou can find troubleshooting guides and other useful information in [docs directory](docs/)\n\n### How it works\nThis project aims to follow the Kubernetes [Operator pattern](https://kubernetes.io/docs/concepts/extend-kubernetes/operator/).\n\nIt uses [Controllers](https://kubernetes.io/docs/concepts/architecture/controller/),\nwhich provide a reconcile function responsible for synchronizing resources until the desired state is reached on the cluster.\n\n## License\n\nCopyright 2024.\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmgruszkiewicz%2Fbackblaze-operator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmgruszkiewicz%2Fbackblaze-operator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmgruszkiewicz%2Fbackblaze-operator/lists"}