{"id":17570718,"url":"https://github.com/PostHog/charts-clickhouse","last_synced_at":"2025-03-07T22:30:25.236Z","repository":{"id":36953198,"uuid":"377324704","full_name":"PostHog/charts-clickhouse","owner":"PostHog","description":"Helm chart for deploying PostHog with ClickHouse on your K8s infrastructure","archived":false,"fork":false,"pushed_at":"2025-01-09T18:08:57.000Z","size":15831,"stargazers_count":60,"open_issues_count":60,"forks_count":77,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-03-05T15:06:45.874Z","etag":null,"topics":["clickhouse","helm-chart","kubernetes","posthog"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PostHog.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":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-06-16T00:14:44.000Z","updated_at":"2025-02-06T12:58:20.000Z","dependencies_parsed_at":"2024-01-16T13:37:45.087Z","dependency_job_id":"142bab85-80ca-4e8b-a378-7eb3da31546a","html_url":"https://github.com/PostHog/charts-clickhouse","commit_stats":null,"previous_names":[],"tags_count":774,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PostHog%2Fcharts-clickhouse","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PostHog%2Fcharts-clickhouse/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PostHog%2Fcharts-clickhouse/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PostHog%2Fcharts-clickhouse/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PostHog","download_url":"https://codeload.github.com/PostHog/charts-clickhouse/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242472683,"owners_count":20134006,"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":["clickhouse","helm-chart","kubernetes","posthog"],"created_at":"2024-10-21T18:01:16.871Z","updated_at":"2025-03-07T22:30:25.191Z","avatar_url":"https://github.com/PostHog.png","language":"Python","funding_links":[],"categories":["Integrations"],"sub_categories":["Deployment and Management Tools"],"readme":"# ⚠️ PostHog no longer supports Kubernetes deployments. ⚠️ \n\n**As of May 2023, [PostHog no longer support Kubernetes deployments](https://posthog.com/blog/sunsetting-helm-support-posthog).** This decision doesn't impact open source (\"Hobby\") users on [Docker Compose deployments](https://posthog.com/docs/self-host). \n\n## What's next?\n\nTo continue using PostHog, you have two options:\n\n### Using PostHog Cloud (Recommended)\nWe strongly encourage users to move to PostHog Cloud wherever possible so that they always have the latest features and the full benefit of official support. It usually works out much cheaper, too. \n\nPostHog Cloud is SOC 2 compliant and available with either EU or US hosting options. If you already have a self-hosted instance, you can [migrate to PostHog Cloud](https://posthog.com/docs/migrate/migrate-between-posthog-instances). Alternatively, you can choose to [migrate to a open source deployment](https://posthog.com/docs/self-host/open-source/deployment) instead. \n\n### Self-hosting PostHog\nIf you want to continue using a self-hosted PostHog deployment then you do so without support. \n\nWe **strongly recommend** following the [official instructions](https://posthog.com/docs/self-host) to deploy PostHog if you must self-host. Most people who modify or use a non-standard way of running this chart run into issues, which we are unable to help with. \n\nSecurity updates will continue until May 2024.\n\n# PostHog Helm Chart\n\n[![Latest release of the Helm chart](https://img.shields.io/badge/dynamic/yaml.svg?label=Helm%20chart%20version\u0026url=https://posthog.github.io/charts-clickhouse/index.yaml\u0026query=$.entries.posthog[:1].version\u0026logo=helm)](https://github.com/PostHog/charts-clickhouse)\n[![Latest release app version](https://img.shields.io/badge/dynamic/yaml.svg?label=App%20version\u0026url=https://posthog.github.io/charts-clickhouse/index.yaml\u0026query=$.entries.posthog[:1].appVersion)](https://github.com/PostHog/posthog)\n[![MIT License](https://img.shields.io/badge/License-MIT-red.svg?style=flat-square)](https://opensource.org/licenses/MIT)\n[![Community](https://img.shields.io/badge/PostHog_chat-slack-blue?logo=slack)](https://posthog.com/questions)\n\n-----\n\n🦔 [PostHog](https://posthog.com/) is a developer-friendly, open-source product analytics suite.\n\nThis Helm chart bootstraps a [PostHog](https://posthog.com/) installation on a [Kubernetes](http://kubernetes.io) cluster using the [Helm](https://helm.sh) package manager.\n\n## Prerequisites\n- Kubernetes \u003e=1.24 \u003c= 1.26\n- Helm \u003e= 3.7.0\n\n## Installation\nDeployment instructions for the major cloud service providers and on-premise deploys are available [here](https://posthog.com/docs/self-host).\n\n## Changelog\nWe documented detailed changes for each major release in our [upgrade notes](https://posthog.com/docs/self-host/deploy/upgrade-notes).\n\n## Development\nWe welcome all contributions to the community, but no longer offer any support. \n\n### Testing\nThis repo uses several types of test suite targeting different goals:\n\n- **lint tests**: to verify if the Helm templates can be rendered without errors\n- **unit tests**: to verify if the rendered Helm templates are as we expect\n- **integration tests**: to verify if applying the rendered Helm templates against a Kubernetes target cluster gives us the stack and PostHog installation we expect\n\n#### Lint tests\nWe use `helm lint` that can be invoked via: `helm lint --strict --set \"cloud=local\" charts/posthog`\n\n#### Unit tests\nIn order to run the test suite, you need to install the `helm-unittest` plugin. You can do that by running: `helm plugin install https://github.com/quintush/helm-unittest --version 0.2.8`\n\nFor more information about how it works and how to write test cases, please look at the upstream [documentation](https://github.com/quintush/helm-unittest/blob/master/README.md) or to the [tests already available in this repo](https://github.com/PostHog/charts-clickhouse/tree/main/charts/posthog/tests).\n\nTo run the test suite you can execute: `helm unittest --helm3 --strict --file 'tests/*.yaml' --file 'tests/clickhouse-operator/*.yaml' charts/posthog`\n\nIf you need to update the snapshots, execute:\n\n```\nhelm unittest --helm3 --strict --file 'tests/*.yaml' --file 'tests/**/*.yaml' charts/posthog -u\n```\n\n#### Integration tests\n- [kubetest](https://github.com/PostHog/charts-clickhouse/tree/main/ci/kubetest): to verify if applying the rendered Helm templates against a Kubernetes target cluster gives us the stack we expect (example: are the disks encrypted? Can this pod communicate with this service?)\n- [k6](https://github.com/PostHog/charts-clickhouse/tree/main/ci/k6): HTTP test used to verify the reliability, performance and compliance of the PostHog installation (example: is the PostHog ingestion working correctly?)\n- [e2e - k3s](https://github.com/PostHog/charts-clickhouse/tree/main/.github/workflows/test-helm-chart.yaml): to verify Helm install/upgrade commands on a local k3s cluster\n- [e2e - Amazon Web Services](https://github.com/PostHog/charts-clickhouse/tree/main/.github/workflows/test-amazon-web-services-install.yaml), [e2e - DigitalOcean](https://github.com/PostHog/charts-clickhouse/tree/main/.github/workflows/test-digitalocean-install.yaml), [e2e - Google Cloud Platform](https://github.com/PostHog/charts-clickhouse/tree/main/.github/workflows/test-google-cloud-platform-install.yaml): to verify Helm install command on the officially supported cloud platforms\n\n\n### Running k3s for tests locally\n\nk6 test is using [k3s](https://k3s.io/) for running things on localhost, which might be tricky to get running locally. Here's one method:\n\n```bash\n# Install k3s without system daemon\ncurl -sfL https://get.k3s.io | INSTALL_K3S_SKIP_ENABLE=true sh\n# Once done run k3s manually, disabling conflicting services\nsudo k3s server --write-kubeconfig-mode 644 --disable traefik --docker --disable-network-policy\n\n# Deploy the chart\nhelm upgrade --install -f ci/values/k3s.yaml --timeout 20m --create-namespace --namespace posthog posthog ./charts/posthog --wait --wait-for-jobs --debug\n\n# Once done, prepare the data/environment\n./ci/setup_ingestion_test.sh\n\nexport KUBECONFIG=/etc/rancher/k3s/k3s.yaml\nexport POSTHOG_API_ADDRESS=$(kubectl get svc -n posthog posthog-web -o jsonpath=\"{.spec.clusterIP}\")\nexport POSTHOG_EVENTS_ADDRESS=$(kubectl get svc -n posthog posthog-events -o jsonpath=\"{.spec.clusterIP}\")\nexport \"POSTHOG_API_ENDPOINT=http://${POSTHOG_API_ADDRESS}:8000\"\nexport \"POSTHOG_EVENT_ENDPOINT=http://${POSTHOG_EVENTS_ADDRESS}:8000\"\nexport \"SKIP_SOURCE_IP_ADDRESS_CHECK=true\"\n\n# Run test\nk6 run ci/k6/ingestion-test.js\n```\n\n### Release\n\nTo release a new chart, bump the `version` in `charts/posthog/Chart.yaml`. We use [Semantic Versioning](https://semver.org/):\n\n    MAJOR version when you make incompatible API changes\n    MINOR version when you add functionality in a backwards compatible manner\n    PATCH version when you make backwards compatible bug fixes\n\nRead API here as the chart values interface. When increasing the MAJOR version, ensure to add\nappropriate documentation to the [Upgrade notes](https://posthog.com/docs/runbook/upgrade-notes).\n\nCharts are [published on push](https://github.com/PostHog/charts-clickhouse/blob/main/.github/workflows/release-chart.yml)\nto the `main` branch.\n\nNote that development charts are also released on PRs such that changes can be tested as required\nbefore merge, e.g. changing staging/dev to use the chart for more end to end validation.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FPostHog%2Fcharts-clickhouse","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FPostHog%2Fcharts-clickhouse","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FPostHog%2Fcharts-clickhouse/lists"}