Groq アップグレード & マイグレーション

概要

Groq SDKバージョンのアップグレードと破壊的変更への対応ガイドです。

前提条件

• 現在のGroq SDKがインストール済み
• バージョン管理用のGit
• テストスイートが利用可能
• ステージング環境

手順

ステップ1: 現在のバージョンを確認

npm list @groq/sdk
npm view @groq/sdk version

ステップ2: 変更ログを確認

open https://github.com/groq/sdk/releases

ステップ3: アップグレードブランチを作成

git checkout -b upgrade/groq-sdk-vX.Y.Z
npm install @groq/sdk@latest
npm test

ステップ4: 破壊的変更に対応

インポートステートメント、設定、メソッドシグネチャを必要に応じて更新します。

出力

• 更新されたSDKバージョン
• 修正された破壊的変更
• テストスイートの成功
• ロールバック手順の文書化

エラーハンドリング

SDKバージョン	APIバージョン	Node.js	破壊的変更
3.x	2024-01	18+	大規模なリファクタリング
2.x	2023-06	16+	認証変更
1.x	2022-01	14+	初期リリース

例

インポート変更

// 以前 (v1.x)
import { Client } from '@groq/sdk';

// 以後 (v2.x)
import { GroqClient } from '@groq/sdk';

設定変更

// 以前 (v1.x)
const client = new Client({ key: 'xxx' });

// 以後 (v2.x)
const client = new GroqClient({
  apiKey: 'xxx',
});

ロールバック手順

npm install @groq/sdk@1.x.x --save-exact

非推奨機能の処理

// 開発環境で非推奨警告を監視
if (process.env.NODE_ENV === 'development') {
  process.on('warning', (warning) => {
    if (warning.name === 'DeprecationWarning') {
      console.warn('[Groq]', warning.message);
      // プロアクティブな更新のために追跡システムに記録
    }
  });
}

// 監視すべき一般的な非推奨パターン:
// - メソッド名変更: client.oldMethod() -> client.newMethod()
// - パラメータ変更: { key: 'x' } -> { apiKey: 'x' }
// - 削除機能: アップグレード前にリリースノートを確認

リソース

• Groq 変更ログ
• Groq マイグレーションガイド

次のステップ

アップグレード時のCI統合については、groq-ci-integrationを参照してください。