wehub-resource-sync
5a558eb09e
TypeScript SDK Compatibility V1.x E2E Tests / Select Node version matrix (push) Has been cancelled
TypeScript SDK Compatibility V1.x E2E Tests / TypeScript SDK Compatibility V1.x E2E Tests Node ${{matrix.node_version}} (push) Has been cancelled
TypeScript SDK E2E Tests / TypeScript SDK E2E Tests Node ${{matrix.node_version}} (push) Has been cancelled
Opik Optimizer - E2E Tests / build-opik (push) Has been cancelled
TypeScript SDK Compatibility V1.x E2E Tests / build-opik (push) Has been cancelled
Python SDK E2E Tests / Select Python version matrix (push) Has been cancelled
Python SDK E2E Tests / Python SDK E2E Tests ${{matrix.python_version}} (push) Has been cancelled
Python SDK E2E Tests / build-opik (push) Has been cancelled
Python SDK Compatibility V1.x E2E Tests / Select Python version matrix (push) Has been cancelled
Python SDK Compatibility V1.x E2E Tests / Python SDK Compatibility V1.x E2E Tests ${{matrix.python_version}} (push) Has been cancelled
Python SDK Compatibility V1.x E2E Tests / build-opik (push) Has been cancelled
TypeScript SDK E2E Tests / Select Node version matrix (push) Has been cancelled
TypeScript SDK E2E Tests / build-opik (push) Has been cancelled
Opik Optimizer - E2E Tests / Opik Optimizer E2E Tests Python ${{matrix.python_version}} (push) Has been cancelled
Opik Optimizer - E2E Tests / Opik Optimizer Integration Smoke Tests (push) Has been cancelled
🐙 Code Quality / detect (push) Has been cancelled
🐙 Code Quality / lint (${{ matrix.leg.name }}) (push) Has been cancelled
🐙 Code Quality / summary (push) Has been cancelled
TypeScript SDK Library Integration Tests / Check Secrets (push) Has been cancelled
TypeScript SDK Library Integration Tests / opik-vercel (Vercel AI SDK / eve) (push) Has been cancelled
SDK Library Integration Tests Runner / Check Secrets (push) Has been cancelled
SDK Library Integration Tests Runner / Missed OpenAI API Key Warning (push) Has been cancelled
SDK Library Integration Tests Runner / Build (push) Has been cancelled
SDK Library Integration Tests Runner / openai_tests (push) Has been cancelled
SDK Library Integration Tests Runner / langchain_tests (push) Has been cancelled
SDK Library Integration Tests Runner / langchain_legacy_tests (push) Has been cancelled
SDK Library Integration Tests Runner / llama_index_tests (push) Has been cancelled
SDK Library Integration Tests Runner / anthropic_tests (push) Has been cancelled
SDK Library Integration Tests Runner / mistral_tests (push) Has been cancelled
SDK Library Integration Tests Runner / groq_tests (push) Has been cancelled
SDK Library Integration Tests Runner / aisuite_tests (push) Has been cancelled
SDK Library Integration Tests Runner / haystack_tests (push) Has been cancelled
SDK Library Integration Tests Runner / dspy_tests (push) Has been cancelled
SDK Library Integration Tests Runner / crewai_v0_tests (push) Has been cancelled
SDK Library Integration Tests Runner / crewai_v1_tests (push) Has been cancelled
SDK Library Integration Tests Runner / genai_tests (push) Has been cancelled
SDK Library Integration Tests Runner / adk_tests (push) Has been cancelled
SDK Library Integration Tests Runner / adk_legacy_1_3_0_tests (push) Has been cancelled
SDK Library Integration Tests Runner / evaluation_metrics_tests (push) Has been cancelled
SDK Library Integration Tests Runner / bedrock_tests (push) Has been cancelled
SDK Library Integration Tests Runner / litellm_tests (push) Has been cancelled
SDK Library Integration Tests Runner / harbor_tests (push) Has been cancelled
SDK Library Integration Tests Runner / Slack Notification (push) Has been cancelled
Lint Opik Helm Chart / render-equality (push) Has been cancelled
Opik Optimizer - Unit Tests / Opik Optimizer Unit Tests Python ${{matrix.python_version}} (push) Has been cancelled
Python BE E2E Tests / Python BE E2E (push) Has been cancelled
Python Backend Tests / run-python-backend-tests (push) Has been cancelled
Python SDK Unit Tests / Python SDK Unit Tests ${{matrix.python_version}} (push) Has been cancelled
Release Drafter / update_release_draft (push) Has been cancelled
SDK E2E Libraries Integration Tests / Check Secrets (push) Has been cancelled
SDK E2E Libraries Integration Tests / Missed OpenAI API Key Warning (push) Has been cancelled
SDK E2E Libraries Integration Tests / build-opik (push) Has been cancelled
SDK E2E Libraries Integration Tests / E2E Lib Integration Python ${{matrix.python_version}} (push) Has been cancelled
TypeScript SDK Integration Build & Publish / build-and-publish (opik-gemini) (push) Has been cancelled
TypeScript SDK Integration Build & Publish / build-and-publish (opik-langchain) (push) Has been cancelled
TypeScript SDK Integration Build & Publish / build-and-publish (opik-openai) (push) Has been cancelled
TypeScript SDK Integration Build & Publish / build-and-publish (opik-otel) (push) Has been cancelled
TypeScript SDK Integration Build & Publish / build-and-publish (opik-vercel) (push) Has been cancelled
TypeScript SDK Build & Publish / build-and-publish (push) Has been cancelled
TypeScript SDK Unit Tests / Test on Node ${{ matrix.node-version }} (push) Has been cancelled
Backend Tests / discover-tests (push) Has been cancelled
Backend Tests / ${{ matrix.name }} (push) Has been cancelled
Build and Publish SDK / build-and-publish (push) Has been cancelled
Build Opik Docker Images / set-version (push) Has been cancelled
Build Opik Docker Images / build-backend (push) Has been cancelled
Build Opik Docker Images / build-sandbox-executor-python (push) Has been cancelled
Build Opik Docker Images / build-python-backend (push) Has been cancelled
Build Opik Docker Images / build-frontend (push) Has been cancelled
Build Opik Docker Images / create-git-tag (push) Has been cancelled
ClickHouse Migration Cluster Check / validate-clickhouse-migrations (push) Has been cancelled
Docs - Publish / run (push) Has been cancelled
E2E Tests - Post Merge (v2) / 🧪 E2E v2 Tests (${{ github.event.inputs.tier || 't1' }}) (push) Has been cancelled
E2E Tests - Post Merge (v2) / 📢 Slack Notification (push) Has been cancelled
Frontend Unit Tests / Test on Node 20 (push) Has been cancelled
Guardrails E2E Tests / Select Python version matrix (push) Has been cancelled
Guardrails E2E Tests / Guardrails E2E Tests ${{matrix.python_version}} (push) Has been cancelled
Guardrails E2E Tests / 📢 Slack Notification (push) Has been cancelled
Guardrails Backend Unit Tests / Guardrails Backend Unit Tests (push) Has been cancelled
Guardrails Backend Unit Tests / 📢 Slack Notification (push) Has been cancelled
Lint Opik Helm Chart / lint-helm-chart (Helm v3.21.0) (push) Has been cancelled
Lint Opik Helm Chart / lint-helm-chart (Helm v4.2.0) (push) Has been cancelled
Lint Opik Helm Chart / unittest-helm-chart (push) Has been cancelled
86 lines
4.6 KiB
Plaintext
86 lines
4.6 KiB
Plaintext
---
|
|
headline: Helm Chart Migration | Opik Documentation
|
|
og:description: Learn how to migrate from Bitnami charts and images to Opik's official Helm chart
|
|
og:site_name: Opik Documentation
|
|
og:title: 'Migrating from Bitnami to Opik Helm Chart'
|
|
subtitle: Guide for migrating from Bitnami charts and images
|
|
title: Migrating from Bitnami Charts and Images
|
|
canonical-url: https://www.comet.com/docs/opik/self-host/helm
|
|
---
|
|
|
|
> **Important:** If you're using or looking to use Opik or Comet enterprise version please reach out to Sales@comet.com to gain access to the correct deployment documentation.
|
|
|
|
# Migrating from Bitnami Charts and Images
|
|
|
|
Opik's Helm chart has migrated from Bitnami charts and images to official Docker images and alternative Helm charts. This migration provides better compatibility, security, and maintainability.
|
|
|
|
## Why Migrate from Bitnami?
|
|
|
|
Bitnami changed its distribution model in 2025:
|
|
|
|
- **Free old public images deprecated**: Versioned images were moved to a "legacy" unmaintained repository with no security updates
|
|
- **Hardened images now subscription-based**: Access to maintained, secure images requires a paid subscription
|
|
- **Bitnami charts tightly depend on Bitnami images**: Bitnami charts cannot switch to official images, creating a dependency on the subscription model
|
|
|
|
By migrating to official Docker images and alternative Helm charts, we ensure:
|
|
|
|
- **Continued Free Access**: Official images from upstream projects (e.g., `mysql`, `redis`, `zookeeper`, `minio`) remain freely available with full version support
|
|
- **Security Updates**: Direct access to security patches and updates from the official maintainers
|
|
- **Production Stability**: Ability to pin specific versions for production deployments
|
|
- **Long-term Sustainability**: Reduced dependency on third-party commercial services
|
|
- **Community Standards**: Official images follow industry best practices and are widely adopted, making it easier to find documentation and community support
|
|
|
|
## Upgrade Instructions
|
|
|
|
If you're upgrading the Opik Helm chart from version **1.9.39** or older, you need to enable the chart migration:
|
|
|
|
```yaml
|
|
chartMigration:
|
|
enabled: true
|
|
```
|
|
|
|
<Warning>
|
|
**Important:** Set `chartMigration.enabled: true` **only** for the first upgrade that includes the migration from Bitnami. After the migration completes successfully, set it back to `false` for subsequent upgrades.
|
|
</Warning>
|
|
|
|
### How the Migration Works
|
|
|
|
The migration is **seamless** and **data-preserving**:
|
|
|
|
1. **Automatic Resource Recreation**: The migration job automatically deletes and recreates StatefulSets and Deployments that are relevant for your installation
|
|
2. **Data Preservation**: All PersistentVolumeClaims (PVCs) are preserved, ensuring no data loss
|
|
3. **Zero Downtime**: The migration happens as a pre-upgrade hook, and new resources are created immediately after
|
|
|
|
### Data Directory Configuration
|
|
|
|
MySQL, MinIO, and Zookeeper are configured to use Bitnami data paths by default to ensure seamless migration:
|
|
|
|
- **MySQL**: Uses `/bitnami/mysql/data` data directory
|
|
- **MinIO**: Uses Bitnami-compatible paths
|
|
- **Zookeeper**: Uses `/bitnami/zookeeper/data` data directory
|
|
|
|
<Note>
|
|
If you originally overrode the default Bitnami data paths in your configuration, make sure your `values.yaml` matches those custom paths to ensure the migration can access your existing data.
|
|
</Note>
|
|
|
|
## What Changed
|
|
|
|
The following components have been migrated to use official Docker images:
|
|
|
|
- **Zookeeper**: Migrated from `bitnami/zookeeper` to official `zookeeper:3.9.4` image using the [CloudPirates Zookeeper](https://github.com/CloudPirates-io/helm-charts/tree/main/charts/zookeeper) chart
|
|
- **MySQL**: Migrated from Bitnami MySQL chart to [comet-mysql-helm](https://github.com/comet-ml/comet-mysql-helm) chart using the official `mysql:8.4.2` image
|
|
- **Redis**: Migrated from Bitnami Redis chart to [CloudPirates Redis](https://github.com/CloudPirates-io/helm-charts/tree/main/charts/redis) chart using the official `redis/redis-stack-server:7.2.0-v10` image
|
|
- **MinIO**: Migrated from Bitnami MinIO chart to [CloudPirates MinIO](https://github.com/CloudPirates-io/helm-charts/tree/main/charts/minio) chart using the official `minio/minio` image
|
|
|
|
## Benefits of Migration
|
|
|
|
- **Official Images**: Using official Docker images provides better security updates and community support
|
|
- **Simplified Configuration**: Reduced complexity in chart dependencies
|
|
- **Better Compatibility**: Improved compatibility with modern Kubernetes versions
|
|
- **Maintained Charts**: Active maintenance and updates from the community
|
|
|
|
## Need Help?
|
|
|
|
If you encounter issues during migration, please check the [troubleshooting guide](/v1/self-host/troubleshooting) or reach out for support.
|
|
|