{"id":21600960,"url":"https://github.com/premiscale/pass-operator","last_synced_at":"2025-04-11T02:12:41.144Z","repository":{"id":217415231,"uuid":"652653202","full_name":"premiscale/pass-operator","owner":"premiscale","description":"A Kubernetes operator that syncs and decrypts secrets from pass store git repositories","archived":false,"fork":false,"pushed_at":"2025-04-10T02:12:56.000Z","size":1652,"stargazers_count":4,"open_issues_count":14,"forks_count":1,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-04-10T03:23:49.851Z","etag":null,"topics":["kubernetes","operator","pass","python","secrets"],"latest_commit_sha":null,"homepage":"https://github.com/premiscale/pass-operator","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/premiscale.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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-06-12T14:13:49.000Z","updated_at":"2025-04-09T17:39:12.000Z","dependencies_parsed_at":"2024-01-19T17:47:34.654Z","dependency_job_id":"7c6839bd-8d10-44aa-a7fe-c3b82fa1d404","html_url":"https://github.com/premiscale/pass-operator","commit_stats":null,"previous_names":["premiscale/pass-operator"],"tags_count":24,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/premiscale%2Fpass-operator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/premiscale%2Fpass-operator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/premiscale%2Fpass-operator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/premiscale%2Fpass-operator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/premiscale","download_url":"https://codeload.github.com/premiscale/pass-operator/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248150453,"owners_count":21055932,"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":["kubernetes","operator","pass","python","secrets"],"created_at":"2024-11-24T19:07:49.106Z","updated_at":"2025-04-11T02:12:41.135Z","avatar_url":"https://github.com/premiscale.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# `pass` secrets operator\n\n![GitHub Release](https://img.shields.io/github/v/release/premiscale/pass-operator)\n![PyPI - License](https://img.shields.io/pypi/l/pass-operator)\n\nA Kubernetes operator to sync and decrypt secrets from a password store ([pass](https://www.passwordstore.org/)) Git repository.\n\nWhile this approach to secrets management on Kubernetes is more technically challenging, the primary advantage is that we don't have to rely on a 3rd party SaaS platform, such as Vault, Infisical or Doppler, to hold and secure our secrets. This approach upholds a GitOps-style of secrets management by storing encrypted secret state in Git.\n\nMoreover, this operator may be used in an airgapped environment or private subnets (with no outbound Internet access) when paired with any self-hosted git repository that supports SSH access, so your secrets never leave your network.\n\n## How it works\n\nFrom a high level, this operator runs `git pull` on an interval to grab updates from a git repository populated with encrypted\nsecrets by `pass` on a local developer's machine. It maps secrets' paths to data values through the application of a [`PassSecret`](helm/operator-crds/templates/PassSecret.yaml), a [custom resource](https://kubernetes.io/docs/concepts/extend-kubernetes/api-extension/custom-resources/), such as the following.\n\n```yaml\napiVersion: secrets.premiscale.com/v1alpha1\nkind: PassSecret\nmetadata:\n  name: mypasssecret\n  namespace: pass-operator-test\nspec:\n  encryptedData:\n    mykey: premiscale/mydata\n  managedSecret:\n    metadata:\n      name: mysecret\n      namespace: mynamespace\n    type: Opaque\n    immutable: false\n```\n\nThe above `PassSecret` manifest translates to the following `Secret`.\n\n```yaml\napiVersion: v1\nkind: Secret\nmetadata:\n  name: mysecret\n  namespace: mynamespace\nstringData:\n  mykey: \u003cdecrypted contents of premiscale/mydata\u003e\nimmutable: false\ntype: Opaque\n```\n\nThe following flowchart outlines how this operator reacts to `PassSecret`-related events and pass store updates.\n\n\u003cp align=\"center\" width=\"100%\"\u003e\n  \u003cimg width=\"100%\" src=\"img/pass-operator-flow.png\" alt=\"pass operator flow diagram\"\u003e\n\u003c/p\u003e\n\n## Installation\n\nSee the [chart README](https://github.com/premiscale/pass-operator/tree/master/helm/operator) for an overview of operator installation and configuration options.\n\n## Development\n\n### Unit tests\n\nRun unit tests with\n\n```shell\nyarn test:unit\n```\n\n### End-to-end tests\n\nInstall [Docker BuildKit and enable it](https://docs.docker.com/build/buildkit/#getting-started).\n\n```text\nDOCKER_BUILDKIT=1\nexport DOCKER_BUILDKIT\n```\n\nNow, run e2e tests with\n\n```shell\nyarn test:e2e\n```\n\nThis command will\n\n1. Stand up a local 1-node minikube cluster with 4 cores, 4GiB memory and 30GiB storage. *(Modify [./scripts/minikube.sh](./scripts/minikube.sh) if these resources are unsuitable for your local development environment.)*\n2. Create a `localhost` docker registry redirect container based on socat.\n3. Build both e2e (hosts a git repository with encrypted pass secrets that match paths found in [./src/test/data/crd](./src/test/data/crd/)) and operator container images, as well as push these images to the local redirect for minikube to access.\n4. Installs both e2e and pass-operator Helm charts.\n5. Run e2e tests.\n6. Tear down the cluster and local registry, as well as cleans up locally-built artifacts.\n\n\u003c!-- ### Coverage\n\nTest coverage against the codebase with\n\n```shell\npoetry run coverage run -m pytest\npoetry run coverage report -m pytest\n``` --\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpremiscale%2Fpass-operator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpremiscale%2Fpass-operator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpremiscale%2Fpass-operator/lists"}