clickhouse-operator

(★ 2,556)

Altinity Kubernetes Operator for ClickHouse creates, configures and manages ClickHouse® clusters running on Kubernetes

파일 탐색기

최종 버전 다운로드 (.zip)

- - build_branch.yaml
  - build_master.yaml
  - check_helm.yaml
  - cosign_sign.yaml
  - release_chart.yaml
  - run_tests.yaml
- - pubring.kbx
  - trustdb.gpg
- - mapping.cfg
- - main.go
- - main.go
- config-dev.yaml
- config.yaml
- secret.yaml
- - build-clickhouse-operator-configs.sh
  - build-clickhouse-operator-install-v1beta1-yaml.sh
  - build-clickhouse-operator-install-yaml.sh
  - cat-clickhouse-operator-install-yaml.sh
  - operatorhub.sh
- - clickhouse-keeper-with-CHK-resource
- - .gitignore
  - clickhouse-operator-delve.run.xml
  - dev-config.sh
  - dev-delete.sh
  - dev-install.sh
  - dev-logs.sh
  - dev-reset.sh
  - dev-run-devspace.sh
  - dev-show.sh
  - dev-watch.sh
  - docker-build.sh
  - docker-clean.sh
  - metrics-exporter-delve.run.xml
  - yq_transform_clickhouse-operator-install.sh
- - create-minio.sh
  - delete-minio.sh
  - install-minio-operator.sh
  - install-minio-tenant.sh
  - minio-tenant-create-bucket-template.yaml
  - minio-tenant-template.yaml
- - clickhouse-operator-delete.sh
  - clickhouse-operator-install-ansible.yaml
  - clickhouse-operator-install-bundle-v1beta1.yaml
  - clickhouse-operator-install-bundle.yaml
  - clickhouse-operator-install-template-v1beta1.yaml
  - clickhouse-operator-install-template.yaml
  - clickhouse-operator-install-tf.yaml
  - clickhouse-operator-install.sh
- - clickhouse-operator-delete.sh
  - clickhouse-operator-install.sh
- - ci.yaml
- - .gitignore
  - clickhouse.test.yaml
  - create-prometheus.sh
  - delete-prometheus.sh
  - install-po-test.sh
  - prometheus-alert-rules-backup.yaml
  - prometheus-alert-rules-chkeeper.yaml
  - prometheus-alert-rules-clickhouse.yaml
  - prometheus-alert-rules-zookeeper.yaml
  - prometheus-alertmanager-template.yaml
  - prometheus-sensitive-data.example.sh
  - prometheus-template.yaml
  - run-alerts-tests.sh
- build_hub_releases.sh
- build_manifests.sh
- find_unformatted_sources.sh
- format_unformatted_sources.sh
- generate_helm_chart.sh
- go_build_all.sh
- go_build_config.sh
- go_build_metrics_exporter.sh
- go_build_metrics_exporter_clean.sh
- go_build_operator.sh
- go_build_operator_clean.sh
- go_build_universal.sh
- image_build_all_altinity.sh
- image_build_all_dev.sh
- image_build_metrics_exporter_altinity.sh
- image_build_metrics_exporter_dev.sh
- image_build_metrics_exporter_universal.sh
- image_build_operator_altinity.sh
- image_build_operator_dev.sh
- image_build_operator_universal.sh
- image_build_universal.sh
- release_evidence.sh
- run_code_generator.sh
- run_go_tests.sh
- run_gocard.sh
- run_gosec.sh
- run_metrics_exporter.sh
- run_operator.sh
- run_vet.sh
- start_new_release_branch.sh
- test_helm_chart.sh
- - Dockerfile
- - Dockerfile
- actions.secret
- - 01-simple-layout-01-1shard-1repl.yaml
  - 01-simple-layout-02-1shard-2repl.yaml
  - 01-simple-layout-03-multiple-clusters-pdb-spec.yaml
  - 01-simple-layout-03-multiple-clusters.yaml
  - 01-simple-layout-04-shards-and-replicas-customization.yaml
  - 01-simple-layout-05-concurrent-reconcile.yaml
  - 02-templates-01-pod-template.yaml
  - 02-templates-02-service-template.yaml
  - 02-templates-03-host-template-volume-claim-and-pod-resources-limit.yaml
  - 02-templates-04-sidecar.yaml
  - 02-templates-05-bootstrap-schema.yaml
  - 02-templates-06-syncUser.yaml
  - 03-persistent-volume-01-default-volume.yaml
  - 03-persistent-volume-02-pod-template.yaml
  - 03-persistent-volume-03-custom-labels-and-annotations.yaml
  - 03-persistent-volume-04-encrypted-volume.yaml
  - 03-persistent-volume-05-resizeable-volume-1.yaml
  - 03-persistent-volume-05-resizeable-volume-2.yaml
  - 03-persistent-volume-06-add-log-volume-1.yaml
  - 03-persistent-volume-06-add-log-volume-2.yaml
  - 03-persistent-volume-07-multiple-resizable-volumes-1.yaml
  - 03-persistent-volume-07-multiple-resizable-volumes-2.yaml
  - 03-persistent-volume-07-multiple-resizable-volumes-3.yaml
  - 03-persistent-volume-07-security-context.yaml
  - 03-persistent-volume-08-tiered-s3.yaml
  - 03-persistent-volume-09-with-template-emptydir.yaml
  - 03-persistent-volume-10-log-volume-local.yaml
  - 04-replication-zookeeper-01-minimal.yaml
  - 04-replication-zookeeper-02-detailed.yaml
  - 04-replication-zookeeper-03-minimal-AWS-persistent-volume.yaml
  - 04-replication-zookeeper-04-medium-AWS-persistent-volume.yaml
  - 04-replication-zookeeper-05-simple-PV.yaml
  - 04-replication-zookeeper-06-on-cluster.yaml
  - 04-replication-zookeeper-07-keeper-ref.yaml
  - 05-settings-01-overview.yaml
  - 05-settings-02-dictionary.yaml
  - 05-settings-03-1-initial-position.yaml
  - 05-settings-03-2-user2.yaml
  - 05-settings-04-nested.yaml
  - 05-settings-05-files-nested.yaml
  - 05-settings-06-tilde.yaml
  - 05-settings-07-network.yaml
  - 05-settings-08-grants.yaml
  - 05-settings-09-projected-configmap.yaml
  - 05-settings-10-macros.yaml
  - 06-advanced-layout-01-one-shard-many-replicas.yaml
  - 06-advanced-layout-02-shards.yaml
  - 06-advanced-layout-03-replicas.yaml
  - 06-advanced-layout-04-multiple-clusters.yaml
  - 07-rolling-update-stateless-01-initial-position.yaml
  - 07-rolling-update-stateless-02-apply-update.yaml
  - 08-clickhouse-version-update-01-initial-position.yaml
  - 08-clickhouse-version-update-02-apply-update-one.yaml
  - 08-clickhouse-version-update-03-apply-update-all.yaml
  - 09-rolling-update-emptydir-01-initial-position.yaml
  - 09-rolling-update-emptydir-02-apply-update.yaml
  - 10-zones-01-simple-01-aws-pods-in-availability-zones.yaml
  - 10-zones-01-simple-02-aws-pod-per-host.yaml
  - 10-zones-02-advanced-01-aws-pods-in-availability-zones.yaml
  - 10-zones-02-advanced-02-aws-pod-per-host.yaml
  - 10-zones-03-advanced-03-pod-per-host-default-storage-class.yaml
  - 10-zones-04-advanced-04-pod-per-host-local-storage.yaml
  - 11-local-storage-01-simple-host-path.yaml
  - 11-local-storage-02-advanced-host-path.yaml
  - 12-troubleshooting-01.yaml
  - 13-distribution-01-distribution-scope.yaml
  - 13-distribution-02-3x3-circular-replication.yaml
  - 13-distribution-03-3x3-distribution-detailed.yaml
  - 14-zones-distribution-01.yaml
  - 15-hostNetwork-01-simple.yaml
  - 15-hostNetwork-02-simple-port-distribution.yaml
  - 15-hostNetwork-03-expanded-port-distribution.yaml
  - 15-hostNetwork-04-simple-fixed-replicas.yaml
  - 15-hostNetwork-05-expanded-fixed-replicas.yaml
  - 16-k8s-metadata-01-custom-labels-and-annotations.yaml
  - 16-k8s-metadata-02-namespace-domain-pattern.yaml
  - 16-k8s-metadata-03-pod-generate-name.yaml
  - 17-monitoring-01-cluster.yaml
  - 17-monitoring-02-prometheus-local-endpoint.yaml
  - 18-schema-init-01-protobuf.yaml
  - 18-schema-init-02-startup-scripts.yaml
  - 19-extensions-01-udf-executable.yaml
  - 20-engines-01-timeseries-prometheus.yaml
  - 21-secure-cluster-secret-01-auto.yaml
  - 21-secure-cluster-secret-02-plaintext.yaml
  - 21-secure-cluster-secret-03-secret-ref.yaml
  - 21-secure-cluster-secret-04-skip-create-user.yaml
  - 22-secure-ssl-01-files-plaintext.yaml
  - 22-secure-ssl-02-files-secret-ref.yaml
  - 22-secure-ssl-03-files-multi-secrets-ref.yaml
  - 22-secure-ssl-04-users-ssl-auth.yaml
  - 23-reconcile-hooks-01-kafka-detach.yaml
  - 23-reconcile-hooks-02-host-replication.yaml
  - 23-reconcile-hooks-03-target-all-hosts.yaml
  - 23-reconcile-hooks-04-combined-cluster-and-host.yaml
  - 24-security-k8s-01-verify-strict.yaml
  - 24-security-tls-01-cluster-strict-verify.yaml
  - 24-security-tls-02-min-version.yaml
  - 24-security-tls-03-cluster-override.yaml
  - 25-fips-01-chopconf.yaml
  - 25-fips-02-cluster.yaml
  - 25-fips-03-cluster-with-backup.yaml
  - 40-aws-s3-arn-role-ec2-credentials.yaml
  - 40-aws-s3-iam-role-irsa.yaml
  - 50-CHIT-01-manual-template-simple.yaml
  - 50-CHIT-02-manual-template-with-selector.yaml
  - 50-CHIT-03-auto-template-volume.yaml
  - 50-CHIT-04-auto-template-volume-with-selector.yaml
  - 50-CHIT-10-useTemplates-and-use-templates-with-selector.yaml
  - 70-chop-config.yaml
  - 98-quota-01.yaml
  - 99-clickhouseinstallation-max.yaml
  - 99-clickhouseoperatorconfiguration-max.yaml
  - label_nodes.sh
- - 01-incorrect-image-create.yaml
  - 02-incorrect-image-update-01-initial-position.yaml
  - 02-incorrect-image-update-02-apply-incorrect-update.yaml
  - 02-incorrect-image-update-03-revert-and-apply.yaml
  - 03-incorrect-settings-create.yaml
  - 04-incorrect-settings-update-01-initial-position.yaml
  - 04-incorrect-settings-update-02-apply-incorrect-update.yaml
  - 04-incorrect-settings-update-03-revert-and-apply.yaml
  - 05-incorrect-pod-template.yaml
- - 101-templates.yaml
  - 102-templates.yaml
  - 103-templates.yaml
  - 104-templates.yaml
  - 105-templates.yaml
  - 107-fips-backup-sidecar.yaml
- - 01-chi-simple-with-keeper.yaml
  - 01-simple-1.yaml
  - 01-simple-3.yaml
  - 02-extended-1-node.yaml
  - 02-extended-3-nodes.yaml
  - 03-zk-to-keeper-gateway-service.yaml
  - 04-private-image-secret.yaml
  - 30-secure-cluster.yaml
  - 31-fips-secure-cluster.yaml
  - 99-clickhousekeeperinstallation-max.yaml
  - clickhouse-keeper-1-node-for-test-only.yaml
  - clickhouse-keeper-3-node-for-test-only.yaml
- - fsm.xmi
  - github_actions_item.png
  - github_actions_menu.png
  - reconciler.png
- architecture.md
- chi_update_add_replication.md
- chi_update_clickhouse_version.md
- clickhouse_config_errors_handling.md
- custom_resource_explained.md
- devspace.md
- fips_evidence_verification.md
- fips_setup.md
- grafana_setup.md
- introduction.md
- k8s_cluster_access.md
- keeper_migration_from_23_to_24.md
- keeper_reference.md
- monitoring_setup.md
- operator_build_from_sources.md
- operator_configuration.md
- operator_installation_details.md
- operator_upgrade.md
- prometheus_setup.md
- pull_request_template.md
- quick_start.md
- README.md
- replication_setup.md
- schema_migration.md
- security_hardening.md
- security_hardening_fips.md
- start_new_release.md
- storage.md
- zookeeper_setup.md
- Altinity_ClickHouse_Operator_dashboard.json
- ClickHouse_Queries_dashboard.json
- ClickHouseKeeper_dashboard.json
- Kafka_dashboard.json
- Zookeeper_dashboard.json
- boilerplate.go.txt
- tools.go
- - announcer.go
  - export.go
- - accessors.go
  - chop.go
  - config_access_rootca_test.go
  - config_manager.go
  - config_manager_test.go
  - ipc_token.go
  - ipc_token_test.go
  - kube_machinery.go
  - kube_machinery_test.go
  - restart.go
- - context.go
  - options.go
- - annotate.go
  - cluster.go
  - config_map.go
  - files_group.go
  - host_template_type.go
  - interfaces-kube.go
  - interfaces-main.go
  - label_type.go
  - name_type.go
  - probe_type.go
  - selector_type.go
  - service_type.go
  - volume_type.go
- - chop_config.go
  - host.go
  - registry.go
  - registry_test.go
  - volumeClaimTemplate.go
- - array.go
  - context.go
  - dir.go
  - dump.go
  - duration.go
  - enum.go
  - enum_test.go
  - fingerprint.go
  - fips140only_test.go
  - fqdn.go
  - fqdn_test.go
  - fs.go
  - hash.go
  - hash_test.go
  - int.go
  - k8s.go
  - map.go
  - messagediff.go
  - print.go
  - prometheus.go
  - replacer.go
  - rfc1035.go
  - shell.go
  - shell_test.go
  - slice.go
  - string.go
- - version.go
- - xml.go
  - xml_test.go
- - docker-compose.yml
- - clickhouse.py
  - install_olm.sh
  - kubectl.py
  - merge_dual_results.py
  - retry_sleep.py
  - run_minikube_dual_reset.sh
  - run_minikube_reset.sh
  - run_tests_acvp_local.sh
  - run_tests_local.sh
  - run_tests_metrics.sh
  - run_tests_metrics_local.sh
  - run_tests_operator.sh
  - run_tests_operator_dual.sh
  - run_tests_operator_local.sh
  - run_tests_parallel.sh
  - settings.py
  - steps.py
  - steps_fips.py
  - test_common.sh
  - test_metrics_exporter.py
  - test_operator.py
  - util.py
  - yaml_manifest.py
- - argparser.py
  - cluster.py
- - build_docker.sh
  - dockerd-start.sh
  - Dockerfile
  - modprobe.sh
  - requirements.txt
- - fips.md
  - fips.py
  - fips_test_plan.md
  - requirements.md
  - requirements.py
- altinity.png
- README.md
- regression.py
- restore_shared_to_replicated.md
- restore_shared_to_replicated.py
- volume_downscale.md
- volume_downscale.sh
.dockerignore
.gitattributes
.gitignore
CHANGELOG.md
CONTRIBUTING.md
devspace.yaml
go.mod
go.sum
LICENSE
NOTICE
README.md
release
release_notes.md
releases
THIRD_PARTY_NOTICES.md
Vagrantfile

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/Altinity/clickhouse-operator

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd clickhouse-operator

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Docker

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Docker Desktop 컨테이너를 빌드하고 실행하려면 필요합니다. 설치 후 실행해서 백그라운드에 켜두세요.

⚠️ 이 프로젝트는 규모가 큰 저장소라, 이 방법이 실제 핵심 제품이 아니라 내부 하위 패키지를 가리키는 것일 수 있습니다. README 전체를 함께 확인해보세요.

docker build -f dockerfile/metrics-exporter/Dockerfile -t clickhouse-operator .

Dockerfile을 기반으로 실행 가능한 이미지를 빌드합니다.

docker run -p 8080:80 clickhouse-operator

빌드된 이미지를 실제 컨테이너로 실행합니다.

✅ 터미널에 docker compose ps 를 입력해 컨테이너들이 Up 상태인지 확인하세요. README에 포트 번호가 적혀있다면 브라우저에서 http://localhost:포트번호 로 접속해보세요.

3. Go

보통

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Go Go 언어 컴파일러 및 도구 모음입니다.

go build ./...

Go 프로그램을 컴파일해 실행 파일을 만듭니다.

go run .

따로 빌드하지 않고 바로 Go 프로그램을 실행합니다.

✅ 빌드가 에러 없이 끝나면 성공입니다. go run . 을 썼다면 터미널 출력을 확인하세요.