自己管理GitLabでのコード提案（PREMIUM SELF BETA）
- GitLab 16.1より、自己管理型GitLabのベータ版として導入されました。
- GitLab 16.1でGoogle Vertex AI Codey APIをサポートしました。
- GitLab 16.2でGitLabネイティブモデルのサポートを削除しました。
- GitLab WebIDE でのコードサジェスチョンをすべての GitLab ホスティングのお客様に有効にしました。
開発中にコードを提案するジェネレーティブAIを使用することで、より効率的にコードを書くことができます。
コードサジェストはGitLab Enterprise Editionでご利用いただけます。Premium と Ultimate サブスクリプション層ではクラウドライセンスが必要です。
Code SuggestionsはGitLab Community Editionではご利用いただけません。
Code Suggestionsの使用にはGitLab Testing Agreementが適用されます。Code Suggestionsを使用する際のデータ使用についてはこちらをご覧ください。
セルフマネジメントのGitLabでCode Suggestionsを有効にします。
セルフマネージドインスタンスでコードサジェスチョンを有効にすると、次のことができるようになります：
- GitLab テスト規約に同意します。
- GitLabがインスタンスから個人データを含むデータをGitLab.comインフラストラクチャに送信することを認めます。
Code Suggestionsを有効にする方法は、GitLabのバージョンによって異なります。
GitLab 16.3 以降
前提条件：
- GitLab 16.3以降にCode Suggestionsを導入された方。
- あなたのインスタンスのすべてのユーザーは、IDE 拡張機能の最新バージョンを持っています。
- 管理者であること。
自分で管理する GitLab インスタンスで Code Suggestions を有効にするには：
- 左のサイドバーで、Search を選択するか、次のページに進んでください。
- Admin Areaを選択します。
- 左サイドバーで、設定 > 一般を選択します。
- Code Suggestions］を展開し、［Turn on Code Suggestions for this instance］を選択します。個人アクセストークン]フィールドには何も入力する必要はありません。
- 変更を保存を選択します。
この設定は、セルフマネージド GitLab インスタンスでのみ表示されます。
Code Suggestionsがすぐに機能するようにするには、手動でサブスクリプションを同期する必要があります。
これでインスタンスのユーザーがCode Suggestionsを使用できるようになります。
GitLab 16.2 以前
前提条件：
- 管理者であること。
- GitLab SaaSアカウントをお持ちです。GitLab SaaSサブスクリプションを持っている必要はありません。
そうすると
- SaaSアカウントのコードサジェストを有効にします。
- インスタンスのコードサジェストを有効にします。
- Code Suggestionsベータ版への早期アクセスをリクエストします。
SaaSアカウントでCode Suggestionsを有効にします。
GitLab SaaSアカウントでCode Suggestionsを有効にします：
-
apiスコープで個人アクセストークンを作成します。 - 左のサイドバーで、自分のアバターを選択してください。
- 環境設定を選択します。
- コードサジェスト] セクションで、[コードサジェストを有効にする] を選択します。
- 変更を保存を選択します。
インスタンスのコードサジェストを有効にします。
自分で管理する GitLab インスタンスで Code Suggestions を有効にするには：
- 左のサイドバーで、Search を選択するか、次のページに進んでください。
- Admin Areaを選択します。
- 左サイドバーで、設定 > 一般を選択します。
-
コード・サジェスチョンを展開し
- このインスタンスのコード・サジェスチョンをオンにする]を選択します。
- Personal access tokenに、GitLab SaaSのパーソナルアクセストークンを入力します。
- 変更を保存を選択します。
この設定は、セルフマネージド GitLab インスタンスでのみ表示されます。
コードサジェストへのアクセスリクエスト
GitLab では、セルフマネージドインスタンス上の Code Suggestions へのアクセスをお客様ごとに提供しています。アクセスをリクエストするには
- GitLab SaaSアカウントにサインインしてください。
- イシュー415393にコメントし、カスタマーサクセスマネージャーをタグ付けしてください。
GitLab がインスタンスに対して Code Suggestions へのアクセスをプロビジョニングした後、インスタンスのユーザーは Code Suggestions を有効にすることができます。
GitLabのアップデート
GitLab 16.3以降では、GitLabはCode Suggestionsのクラウドライセンス要件を実施しています：
- Premium と Ultimate サブスクリプション層はクラウドライセンスをサポートしています。
- GitLab Freeはクラウドライセンスをサポートしていません。
GitLab Freeのサブスクリプションをお持ちで、GitLab 16.3以降にアップデートされた場合、Code Suggestionsへの早期アクセスを継続するには、次のことが必要です：
- クラウドライセンスをサポートするサブスクリプションを持っていること。
- IDE エクステンションが最新バージョンであることを確認してください。
- サブスクリプションを手動で同期します。
手動で購読を同期
以下の場合は、手動で購読を同期する必要があります：
- GitLab 16.3にアップデート済みで、PremiumまたはUltimateレベルのサブスクリプションを購入したばかりの場合。
- すでにPremiumまたはUltimateのサブスクリプションをお持ちで、GitLab 16.3にアップデートしたばかりです。
手動同期を行わないと、インスタンスで Code Suggestions が有効になるまで最大 24 時間かかる場合があります。
コードサジェストを使用
前提条件：
- インスタンスでCode Suggestionsが有効になっている必要があります。
- サポートされている IDE エディター拡張機能をインストールし、設定している必要があります。
コードサジェスチョンを使用するには
-
コードを作成します。入力すると、サジェストが表示されます。カーソルの位置に応じて、拡張子は次のいずれかになります：
- 関数の生成など、コード全体のスニペットを提供します。
- 現在の行を補完します。
-
提案を受け入れるには、Tabを押します。
提案は新しいコードを書くときに最適です。既存の関数を編集したり、関数の’途中を埋める’ことは、期待通りに動作しないかもしれません。
GitLabはコードサジェストの品質を向上させるために改善を進めています。AIは非決定的なので、同じ入力で毎回同じサジェストが出るとは限りません。
この機能は現在ベータ版です。Code SuggestionsはGoogle Vertex AI Codey APIとGitLab Code Suggestionsサービスの両方に依存しています。GitLabは、この機能を優雅に劣化するように構築し、悪用や誤用を軽減できるように制御しています。GitLabは、当社の判断により、いつでもこの機能をすべてのお客様に対して無効にすることができます。
データのプライバシー
セルフマネージドGitLabインスタンスはコードサジェストを生成しません。セルフマネージドインスタンスへの認証に成功すると、トークンが生成されます。
IDE/エディタはこのトークンを使って、GitLab.comのコードサジェストサービスにデータを安全に直接送信し、処理します。
コードサジェストサービスは、AIが生成したコードサジェストを安全に返します。
GitLabもGoogle Vertex AI Codey APIも、コードサジェストを生成するために送信されたもの以外に、自己管理されている顧客のコードを可視化することはできません。