更新とロールバック
CodeCanvas インスタンスの更新方法は、マイナーアップデートかメジャーアップデートかによって異なります。CodeCanvas のバージョンは、[Major version year].[Major version update].[Minor version]（例: 2024.1.1）の 3 つの部分で構成されています。
マイナーアップデート
これらのアップデートは、CodeCanvas のマイナーバージョンを、たとえば 2024.1.0 から 2024.1.1 に変更します。このようなアップデートでは大きな変更はなく、通常はバグ修正とセキュリティパッチが含まれます。
CodeCanvas を最新のマイナーバージョンに更新するには
Helm リリースをアップグレードします。
helm -n NAMESPACE_PLACEHOLDER upgrade codecanvas \ oci://public.registry.jetbrains.space/p/codecanvas/release-charts/codecanvas \ -f values.yamlここで、
values.yamlは現在の CodeCanvas インスタンスの値ファイルです。
CodeCanvas を以前のマイナーバージョンにロールバックするには
CodeCanvas リリースの利用可能なリビジョンを一覧表示します。
helm history codecanvas -n NAMESPACE_PLACEHOLDERコマンド出力は次のようになります。
REVISION UPDATED STATUS CHART APP VERSION DESCRIPTION 1 Mon Mar 1 15:00:00 2024 SUPERSEDED codecanvas-2024.1.0 2024.1.0 Install complete 2 Mon Aug 1 16:30:00 2024 DEPLOYED codecanvas-2024.1.1 2024.1.1 Upgrade completeたとえば、2024.1.0 バージョン (リビジョン 1) にロールバックするとします。
前のリビジョンにロールバックします:
helm rollback codecanvas 1 -n NAMESPACE_PLACEHOLDERここで、
1は以前のリリースのリビジョン番号です。リリース履歴をもう一度表示すると、出力は次のようになります。
REVISION UPDATED STATUS CHART APP VERSION DESCRIPTION 1 Mon Mar 1 15:00:00 2024 SUPERSEDED codecanvas-2024.1.0 2024.1.0 Install complete 2 Wed Aug 1 16:30:00 2024 SUPERSEDED codecanvas-2024.1.1 2024.1.1 Upgrade complete 3 Fri Sep 1 16:45:00 2024 DEPLOYED codecanvas-2024.1.0 2024.1.0 Rollback to 1
主要なアップデート
これらのアップデートにより、CodeCanvas のメジャーバージョンが変更されます（例: 2024.1.1 から 2024.2.0、または 2024.1.1 から 2025.1.1）。これらのアップデートにより新機能が追加され、データベースやインフラストラクチャの構成変更が必要になる場合があります。メジャーアップデートを実行するには、このセクションの説明に従って CodeCanvas データを移行する必要があります。
CodeCanvas を最新のメジャーバージョンに更新するには
PostgreSQL データベースに保存されている CodeCanvas データをバックアップしてください。何か問題が発生した場合、アップデートをロールバックするためにこのデータが必要になる場合があります。メジャーアップデートでは、データベーススキーマも更新されます。つまり、データベースを復元しない限り、以前のバージョンにロールバックすることはできません。
アップグレード先のリリースにおける Helm チャートの変更内容については、新機能セクションをご確認ください。変更がある場合は、
values.yamlファイルを適宜更新してください。例: 新しいバージョンでは、デフォルトの開発コンテナーイメージに変更が加えられる場合があります。詳細は下記を参照してください。Helm リリースを最新バージョンにアップグレードします。
helm -n NAMESPACE_PLACEHOLDER upgrade codecanvas \ oci://public.registry.jetbrains.space/p/codecanvas/release-charts/codecanvas \ -f values.yamlここで、
values.yamlは現在の CodeCanvas インスタンスの値ファイルです。CodeCanvas は、CodeCanvas pod の起動時にデータ移行を実行します。データ量が多い場合は、数分かかる場合があります。すべての pods が
ready状態になったら、新しい CodeCanvas バージョンの使用を開始できます。
CodeCanvas を以前のメジャーバージョンにロールバックするには
CodeCanvas アプリケーションを停止します。
更新前に作成したバックアップから CodeCanvas PostgreSQL データベースを復元します。
CodeCanvas リリースの利用可能なリビジョンを一覧表示します。
helm history codecanvas -n NAMESPACE_PLACEHOLDERコマンド出力は次のようになります。
REVISION UPDATED STATUS CHART APP VERSION DESCRIPTION 1 Mon Mar 1 15:00:00 2024 SUPERSEDED codecanvas-2024.1.0 2024.1.0 Install complete 2 Mon Aug 1 16:30:00 2024 DEPLOYED codecanvas-2024.2.0 2024.2.0 Upgrade completeたとえば、2024.1.0 バージョン (リビジョン 1) にロールバックするとします。
前のリビジョンにロールバックします:
helm rollback codecanvas 1 -n NAMESPACE_PLACEHOLDERここで、
1は以前のリリースのリビジョン番号です。リリース履歴をもう一度表示すると、出力は次のようになります。
REVISION UPDATED STATUS CHART APP VERSION DESCRIPTION 1 Mon Mar 1 15:00:00 2024 SUPERSEDED codecanvas-2024.1.0 2024.1.0 Install complete 2 Wed Aug 1 16:30:00 2024 SUPERSEDED codecanvas-2024.2.0 2024.2.0 Upgrade complete 3 Fri Sep 1 16:45:00 2024 DEPLOYED codecanvas-2024.1.0 2024.1.0 Rollback to 1
メジャーアップデートとデフォルトの開発コンテナーイメージ
CodeCanvas を新しいメジャーバージョンにアップデートすると、デフォルトの開発コンテナーイメージもアップデートされます。新しいイメージによって互換性のない変更（たとえば、下位互換性のないツールの新しいバージョンなど）が導入される可能性があるため、既存の開発環境で問題が発生する可能性があります。
ユーザーが既存の開発環境を再起動すると、CodeCanvas は新しい開発環境を作成し、ユーザーのデータを含む既存のボリュームをそこにマウントします。つまり、メジャーアップデート後にユーザーが環境（デフォルトイメージベース）を再起動すると、この開発環境は更新された開発コンテナーイメージを使用します。
問題が発生する場合は、システム管理者は Helm チャートの値に開発コンテナーイメージの特定のバージョンをピン留めすることができます。これにより、すべての新しい開発環境でピン留めされたイメージが使用されるようになります。これを行うには、values.yaml ファイルに以下のプロパティを追加し、CodeCanvas インスタンスに変更を適用します。
関連ページ：
アーキテクチャー
CodeCanvas は、スケーラビリティと信頼性を重視し、Kubernetes クラスターへのデプロイ向けに設計されています。Amazon EKS、Azure AKS、Google GKE などの主要なクラウドプロバイダーへのインストールを想定しています。オンプレミスインフラストラクチャのサポートも予定されています。クラスター：典型的な CodeCanvas インストールは、CodeCanvas アプリケーションクラスターと任意の数の開発環境クラスターで構成されます。CodeCanvas ク...
新機能
2025.3.1 – 2025.3.3：インストール Helm チャートの変更 2025.3.1 – 2025.3.3 の CodeCanvas Helm チャートは、2025.3 と比べて変更はありません。アップグレード前にファイルを更新する必要はありません。2025.2 以前からアップグレードする場合は、ファイルを更新する必要があります。バグ修正とマイナーな改善これはバグ修正とマイナーな改善を含むパッチリリースです。2025.3：インストール Helm チャートの変更 2025.3 の Code...
CodeCanvas を構成する
このガイドは、システム管理者 (組織内の CodeCanvas インスタンスの設定と管理を担当するシステム管理者ロールを持つユーザー) を対象としています。システム管理者は、プラットフォームのインストールとアクティベート、認証の設定、開発環境のコンピューティングリソースの定義、グローバル設定の管理などを行います。CodeCanvas インスタンスを準備しましょう !1. CodeCanvas インスタンスをアクティブ化する：ブラウザーで、インストール時に指定した CodeCanvas URL...