{"id":21539390,"url":"https://github.com/nextdoor/k8s-charts","last_synced_at":"2026-01-04T05:06:06.955Z","repository":{"id":37080803,"uuid":"345725500","full_name":"Nextdoor/k8s-charts","owner":"Nextdoor","description":"Internal Helm Chart Repository","archived":false,"fork":false,"pushed_at":"2025-02-11T01:54:30.000Z","size":1471,"stargazers_count":3,"open_issues_count":8,"forks_count":1,"subscribers_count":71,"default_branch":"main","last_synced_at":"2025-02-11T02:29:48.560Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Smarty","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/Nextdoor.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":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-03-08T16:43:34.000Z","updated_at":"2025-01-21T21:48:39.000Z","dependencies_parsed_at":"2022-07-12T03:00:18.226Z","dependency_job_id":"cbf788a1-4cd8-4eb0-981e-6755f3060463","html_url":"https://github.com/Nextdoor/k8s-charts","commit_stats":null,"previous_names":[],"tags_count":491,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nextdoor%2Fk8s-charts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nextdoor%2Fk8s-charts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nextdoor%2Fk8s-charts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nextdoor%2Fk8s-charts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Nextdoor","download_url":"https://codeload.github.com/Nextdoor/k8s-charts/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244116508,"owners_count":20400733,"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":[],"created_at":"2024-11-24T04:15:06.001Z","updated_at":"2026-01-04T05:06:06.927Z","avatar_url":"https://github.com/Nextdoor.png","language":"Smarty","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Nextdoor Helm Chart Components\n\nThis repo holds a series of common helm-charts that we've developed just to\nhelp speed up our internal development and reduce repetition. There's no\nunique business logic or anything private here.\n\n# Security - Read Me First!\n\n**This is critical - absolutely no private information may be checked into this\nrepository. Read this!**\n\nThis repository is public - internet-facing. We use this repository purely to\nkeep reusable \"components\" available to developers to make their Helm lives\neasier. The components in this repository are intended to be completely general\npurpose and reusable, and should be testable entirely without any privilged\naccess.\n\n## Repository Setup\n\nThe repository metadata and artifacts are hosted by Github. All the data here\nis publically accessible to make development easy. Also, it makes testing these\ncharts easier (see comments below around testing).\n\n    $ helm repo add nextdoor https://k8s-charts.nextdoor.com/\n    $ helm repo update\n    $ helm search repo nextdoor\n    NAME                      \tCHART VERSION\tAPP VERSION\tDESCRIPTION\n    nextdoor/simple-app\t        0.1.0        \t0.0.1      \tHelm Chart that provisions a series of common P...\n\n## Using a Chart\n\nAll charts are fully documented in their individual values files. Use `helm\nsearch repo nextdoor` to list the charts and `helm show values nextdoor/\u003cchart\nname\u003e` to see the options for the charts.\n\n## Using Charts in your Helm Chart\n\nThe intention of this repository is to make re-usable components - not projects\nthat are launched on their own. Given your existing `Chart.yaml` that looks like this:\n\n\n    apiVersion: v2\n    appVersion: \"1.0\"\n    description: Launches the Nextdoor Widget Service\n    name: neighbors-widget\n    version: 0.1.0\n\nYou can add a simple `dependencies` section to bring in a component chart, and\nthen configure it with your `values.yaml` files. Here's the new `Chart.yaml` for example:\n\n    apiVersion: v2\n    appVersion: \"1.0\"\n    description: Launches the Nextdoor Widget Service\n    name: neighbors-widget\n    version: 0.1.0\n    dependencies:\n      - name: prometheus-alerts\n        version: 0.0.2\n        repository: https://k8s-charts.nextdoor.com\n\nAnd you might then configure your `values.yaml` like this:\n\n    # My own app configs..\n    image: ...\n    tag: ...\n\n    # Customize the alerting for this project\n    prometheus-alerts:\n      alertManager:\n        enabled: true\n        pagerduty:\n          routing_key: ...\n\n# Developing Component Charts\n\nIf you want to improve on a component chart here - or create your own - you\nneed to know a few things about the requirements in this repository. Please\nread through this section thoroughly before creating a Pull Request.\n\n## Chart Paths\n\nAll charts live in the [`/charts`](charts/) directory. The name of the chart\nmust match the name of the directory - for example,\n[`charts/simple-app`](charts/simple-app) matches the `Name` key in the\n[`charts/simple-app/Chart.yaml`](charts/simple-app/Chart.yaml) file.\n\n## Revving Chart Versions\n\n[helm_best_practices]: https://helm.sh/docs/chart_best_practices/conventions/#version-numbers\n[semver2]: https://semver.org/\n\nOn every single chart change, you must rev the `version` key in the\n`Chart.yaml` file. We follow the [Helm Best Practices][helm_best_practices]\nguide and use the [Semantic Versioning 2.0.0][semver2] pattern for all\nversioning:\n\n  * MAJOR version when you make incompatible API changes,\n  * MINOR version when you add functionality in a backwards compatible manner, and\n  * PATCH version when you make backwards compatible bug fixes.\n\n## Generating Updated Chart Documentation\n\n[helm_docs]: https://github.com/norwoodj/helm-docs\n\nAs part of our [CI tests](.github/workflows/ci.yaml), we verify that the\n`README.md` in the chart directory matches the `values.yaml` file properly\nusing the [helm_docs][helm_docs] command. This process ensures that each and\nevery change to a repository includes the latest and current documentation.\n\nIf your [dotfiles](https://github.com/Nextdoor/dotfiles.git) is updated, then\nyou can just run `helm_docs` from inside the chart directory to update the\ndocumentation before committing your code:\n\n    $ helm_docs\n    time=\"2021-03-16T15:44:46Z\" level=info msg=\"Found Chart directories [charts/simple-app]\"\n    time=\"2021-03-16T15:44:46Z\" level=info msg=\"Generating README Documentation for chart /helm-docs/charts/simple-app\"\n\n## Maintainers\n\nAll charts must have a `maintainers` section that indicates who has primarily\nbeen responsible for owning the health of that chart. The `name` maps to your\nGithub username, but please use your corporate email address for the `email`\nkey.\n\n```yaml\nmaintainers:\n  - name: diranged\n    email: matt@nextdoor.com\n```\n\n## Chart Testing\n\n[ct_tool]: https://github.com/helm/chart-testing\n\nAll Charts will automatically be run through the [Helm Chart Testing][ct_tool]\ntool as part of the CI process. You must be able to mock out the\nNextdoor-specific settings (like ECR images for example) with publically\navailable components because the CI process takes place in Github Actions. \n\n*This is an intentional decision - it makes it impossible to ship a chart to\nthe repository that contains references to private internal ECR images.*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnextdoor%2Fk8s-charts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnextdoor%2Fk8s-charts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnextdoor%2Fk8s-charts/lists"}