コンフィグストアの使用

コンフィグストアはバージョンレスコンテナの一種です。ここに頻繁に使用されるデータをエッジから読み込みできるキーと値のペアとして保存することができ、お客様のアカウントの複数の Compute サービス で共有できるようになります。

また、API 経由でコンフィグストアの作成や使用を行うこともできます。

前提条件

コンフィグストアは、Fastly の Compute サービスでのみご利用いただけます。CDN (VCL ベース) サービスではご利用いただけません。

制約と考慮事項

コンフィグストアの作成または変更を行う際には、以下の点に留意してください。

• コンフィグストアは Compute サービスでのみご利用いただけます。CDN (VCL ベース) サービスではご利用いただけません。
• Compute のトライアルには、最大100エントリのコンフィグストアが1つ含まれています。
• 有料アカウントには、少なくとも5つのコンフィグストアが含まれています (各最大500エントリ)。
• コンフィグストアのキーは255文字まで、値は8,000文字までに制限されています。
• コンフィグストア、キーの名前および値では、大文字と小文字が区別されます。

コンフィグストアの作成

コンフィグストアを作成するには、サービスに関連付ける前に、少なくとも1つのキーと値のペアを作成する必要があります。新しいコンフィグストアと、そのキーと値ペアを作成する手順は次のとおりです。

1. Fastly コントロールパネルにログインします。
2. Resources > Config stores に移動します。
3. Create a config store をクリックします。
4. Name of config store フィールドにコンフィグストアの名前を入力し、Add をクリックします。
5. Key-value pairs リンクをクリックします。
6. Add item をクリックします。
7. 該当する列にキーと値を入力し、Add をクリックします。
8. 必要に応じて、キーと値のペアの追加を続行します。

コンフィグストアをサービスにリンクする

少なくとも1つのキーと値のペアをコンフィグストアに追加すると、Resources コントロールまたはサービスのサービス設定からコンフィグストアを1つ以上のサービスにリンクすることができます。同ストアに対して行われる後続の更新はすべて、リンクされたサービスに自動的に反映されます。

Resources コントロールを使用してコンフィグストアをサービスにリンクする

以下の手順に従って、Resources コントロールからコンフィグストアをサービスにリンクできます。

1. Fastly コントロールパネルにログインします。

2. Resources > Config stores に移動します。

3. リンクするストアの右側にある Link to services をクリックします。

4. コンフィグストアをリンクするサービスの横にあるチェックボックスを選択します。

5. Next をクリックします。

6. どのサービスのバージョンにリンクするかを決定します。デフォルトでは、最も最近に有効化されたサービスバージョンをクローンするとシステムは想定します。サービスの既存のドラフトバージョンを選択する場合は、Version メニューからそのバージョンを選択します。

7. ストアをサービスにリンクするには、以下のオプションのいずれかを選択します。

   • Link only: 選択したサービスバージョンにストアがリンクされますが、クローンまたはドラフトバージョンは後で有効化できるように、有効化されていない状態で維持されます。

   • Link and activate: 選択したサービスバージョンにストアがリンクされ、同時にそれらのバージョンが有効化されます。

   コンフィグストアがサービスにリンクされると、正常にリンクされたことを示すメッセージが表示されます。

8. 最後に、以下のいずれかの操作を行います。

   • Activate versions をクリックし、コンフィグストアにリンクされているサービスのクローンまたはドラフトバージョンを有効化します。
   • Finish をクリックし、サービスのクローンまたはドラフトバージョンは有効化せずに、後で追加の設定変更を行ってから有効化できるようにします。

   エッジロジックで、直ちにコンフィグストアを参照し始めることができます。

サービス設定を使用してコンフィグストアをサービスにリンクする

以下の手順に従って、サービス設定からコンフィグストアをサービスにリンクできます。

1. Fastly コントロールパネルにログインします。
2. Home ページから、適切なサービスを選択します。検索ボックスで ID、名称、ドメインによる検索が行えます。
3. Service configuration をクリックします。
4. ページ上のナビゲーションにある Resources オプションで、Config stores をクリックします。
5. Link Config Store to service メニューから、サービスにリンクするコンフィグストアを選択します。コンフィグストアがサービスにリンクされると、正常にリンクされたことを示すメッセージが表示されます。

リンクが完了すると、エッジロジックで直ちにコンフィグストアを参照できるようになるため、準備ができ次第、サービスを有効化できます。

コンフィグストアのリンクを解除する

サービス設定で、サービスからコンフィグストアのリンクを解除することができます。

以下の手順に従って、コンフィグストアのリンクを解除できます。

1. Fastly コントロールパネルにログインします。
2. Home ページから、適切なサービスを選択します。検索ボックスで ID、名称、ドメインによる検索が行えます。
3. Service configuration をクリックします。
4. ページ上のナビゲーションにある Resources オプションで、Config stores をクリックします。
5. サービスへのリンクを解除するコンフィグストアの横にある Unlink from service をクリックします。
6. Confirm and unlink をクリックします。サービスの新しいドラフトバージョンが作成されます。
7. サービスを有効化し、コンフィグストアのリンク解除を完了します。

コンフィグストアの編集

コンフィグストアの名前と、ストア内のキーと値のペアは、Resources > Config stores 内で編集できます。このページには、サービス設定からコンフィグストアにアクセスし、Edit in Resources をクリックしてアクセスすることもできます。

コンフィグストアの名前を変更する手順は次のとおりです。

1. 名前を変更するストアの右側にある鉛筆アイコン をクリックします。
2. コンフィグストアの新しい名前を入力します。
3. Save、Confirm and rename の順にクリックして続行します。

新しいキーと値のペアをコンフィグストアに追加する手順は次のとおりです。

1. Key-value pairs セクションを展開します。
2. Key-value pairs の下にある Add item をクリックします。
3. 該当する列にキーと値を入力し、Add をクリックします。
4. 他にもキーと値のペアがあれば、この操作を繰り返します。

コンフィグストア内のキーと値のペアを編集する手順は次のとおりです。

1. Key-value pairs セクションを展開します。
2. 編集するエントリーにカーソルを合わせ、Edit をクリックします。
3. 必要に応じてキーまたは値を編集します。
4. Save をクリックします。

コンフィグストアに関連付けられたデプロイ済みのサービスバージョンを含め、おこなった変更は設定に直ちに適用されます。

コンフィグストアの削除

コンフィグストアはいつでも削除することができます。コンフィグストアのサービスへのリンクはすべて解除されている必要があります。解除されていない状態で削除しようとすると、エラーが表示されます。

コンフィグストアを削除すると、ストア内のすべてのキーと値のペアも削除されます。これらのキーを参照するカスタムロジックがある場合は、ストアを削除する前にこれらの参照を更新してください。

コンフィグストアを削除する手順は次のとおりです。

1. Fastly コントロールパネルにログインします。
2. Resources > Config stores に移動します。
3. 削除したいストアの右側にあるゴミ箱アイコン をクリックします。
4. Confirm and Delete をクリックします。