データキャッシュを作成および管理する方法 - Elastic Container Instance

データキャッシュから事前にデータをプルできます。その後、エラスティックコンテナインスタンスを作成するときに、データをマウントして使用できます。このトピックでは、データキャッシュの作成に使用するパラメーターについて説明します。また、データキャッシュの作成、クエリ、更新、コピー、削除の方法についても説明します。

データキャッシュの作成

次のいずれかの方法を使用して、データキャッシュを作成できます。

API: CreateDataCacheオペレーションを呼び出して、データキャッシュを作成できます。詳細については、CreateDataCacheを参照してください。
コンソール: エラスティックコンテナインスタンスコンソールの左側のナビゲーションペインで、データキャッシュをクリックします。「データキャッシュ」ページで、データキャッシュの作成をクリックします。必要に応じてデータキャッシュパラメーターを設定し、OKをクリックします。

構成の説明

データキャッシュを作成するときは、次のパラメーターを設定する必要があります。

基本プロパティ

API	コンソール	説明
RegionId	リージョン	データキャッシュが属するリージョン。
Bucket	キャッシュバケット	データが格納されるバケット。デフォルトでは、defaultという名前のバケットが使用されます。カスタムバケットを使用してビジネスをグループ化し、パスの競合を防ぐことができます。 eci-systemという名前のバケットは、エラスティックコンテナインスタンスの共通キャッシュを格納するために予約されており、このパラメーターの値として使用することはできません。
Path	キャッシュディレクトリ	データの格納パス。
Name	キャッシュ名	データキャッシュの名前。
Size	キャッシュサイズ	データキャッシュのサイズ。単位: GiB。デフォルト値: 20。実際のデータ量に基づいて必要なサイズを評価します。
RetentionDays	保存期間（日数）	データキャッシュが保持される日数。保存期間が経過すると、データキャッシュは削除されます。デフォルトでは、データキャッシュは期限切れになりません。

データソースパラメーター

API	コンソール	説明
DataSource.Type	タイプ	データソースのタイプ。
DataSource.Options	パラメーター	データソースのパラメーター。この値はJSONオブジェクトです。データソースの種類によって、必要なパラメーターが異なります。

次の表は、さまざまな種類のデータソースとそのパラメーターを示しています。

重要

APIオペレーションを呼び出してデータキャッシュを作成する場合、DataSource.Optionsパラメーターの下の各パラメーターの前にパラメーター名の長さを追加する必要があります。たとえば、urlは#3#url、repoIdは#6#repoId、repoSourceは#10#repoSourceと記述する必要があります。SDKを使用してデータキャッシュを作成する場合は、これは不要です。

type	説明	options
URL	ハイパーリンクアドレス	url: データをダウンロードするURL。 accessToken: プライベートデータをプルする前に認証に使用されるトークン。
URL	HuggingFaceまたはModelScope	repoSource: ModelScopeまたはHuggingFaceコミュニティからモデルまたはデータセットをプルします。有効な値: ModelScope/Model、ModelScope/DataSet、HuggingFace/Model、HuggingFace/DataSet。 repoId: モデルまたはデータセットのID。 revision: バージョン。デフォルト値: mainまたはmaster。 accessToken: プライベートデータをプルする前に認証に使用されるトークン。
NAS	ファイルストレージNAS (NAS) ファイルシステム	server: NASファイルシステムのマウントターゲット。 path: NASファイルシステムのサブディレクトリ。Extreme NASファイルシステムの場合は、パスの前に`/share`を付けます。例: `/share/path`。 vers: NASファイルシステムのマウントに使用されるNFS (Network File System) プロトコルのバージョン番号。NFS v3を使用することをお勧めします。Extreme NASはNFS v3のみをサポートしています。 options: typeパラメーターをNASに設定するときに使用されるパラメーター。NASサービスで推奨されるパラメーターを使用することをお勧めします。例: `nolock,tcp,noresvport`。
OSS	オブジェクトストレージサービス (OSS) バケット	bucket: OSSバケットの名前。 url: OSSバケットのエンドポイント。 path: OSSバケットのサブディレクトリ。パスはOSSバケットのルートディレクトリからの相対パスです。デフォルト値: `/`。 otherOpts: OSSバケットをマウントするために指定されたカスタムオプション。形式: `-o * -o `。例: `-o max_stat_cache_size=0 -o allow_other`。 ramRole: RAMを使用して権限を付与する場合に使用されるResource Access Management (RAM) ロール。説明 RAMロールを作成し、OSSバケットにアクセスするための権限をRAMロールに付与します。詳細については、信頼できるAlibaba CloudサービスのRAMロールの作成およびRAMロールへの権限の付与を参照してください。 RAMロールを作成するときは、「信頼できるエンティティの選択」パラメーターでAlibaba Cloudサービス、「ロールタイプ」パラメーターで標準サービスロール、「信頼できるサービスの選択」パラメーターでElastic Compute Serviceを選択します。RAMロールに権限を付与するときは、AliyunOSSFullAccess*ポリシーをRAMロールにアタッチします。 akId: AccessKeyペアを使用して権限を付与する場合に使用されるAccessKey ID。詳細については、AccessKey ペアの作成を参照してください。 akSecret: AccessKeyペアを使用して権限を付与する場合に使用されるAccessKeyシークレット。詳細については、AccessKey ペアの作成を参照してください。
SNAPSHOT	スナップショット	snapshotId: スナップショットのID。

ネットワークパラメーター

インターネット経由でデータをプルする場合、接続されているvSwitchにSNATエントリが設定されていない場合は、エラスティックコンテナインスタンスにエラスティックIPアドレス (EIP) を関連付けることができます。

API	コンソール	説明
EipInstanceId	既存のものを使用	既存のEIPをエラスティックコンテナインスタンスに関連付けます。
EipCreateParamパラメーターの下のパラメーター。	自動作成	EIPを自動的に作成し、エラスティックコンテナインスタンスに関連付けます。

その他のパラメーター
上記のパラメーターに加えて、データキャッシュを作成するときに一時リソースの作成に使用されるパラメーター（仮想プライベートクラウド (VPC)、vSwitch、セキュリティグループのパラメーターなど）も設定する必要があります。

構成例

次の例は、APIモードでさまざまなタイプのデータキャッシュを作成する方法を示しています。

URL

URLからデータをプルする

{
  "RegionId": "cn-beijing",
  "SecurityGroupId": "sg-2ze63v3jtm8e6syi****",
  "VSwitchId": "vsw-2ze94pjtfuj9vaymf****",
  "Bucket": "test",
  "Path": "/demo/url",
  "Name": "test-url-1",
  "DataSource": {
    "Type": "URL",
    "Options": {
      "#10#url": "https://www.example.com" // URLを指定
    }
  },
  "RetentionDays": 1
}

HuggingFaceからモデルをプルする

{
  "RegionId": "cn-beijing",
  "SecurityGroupId": "sg-2ze63v3jtm8e6syi****",
  "VSwitchId": "vsw-2ze94pjtfuj9vaymf****",
  "Bucket": "test",
  "Path": "/demo/url",
  "Name": "test-url-2",
  "DataSource": {
    "Type": "URL",
    "Options": {
      "#10#repoSource": "HuggingFace/Model", // HuggingFaceのモデルを指定
      "#6#repoId": "stabilityai/stable-diffusion-2-1" // モデルIDを指定
    }
  },
  "RetentionDays": 1
}

NAS

{
  "RegionId": "cn-beijing",
  "SecurityGroupId": "sg-2ze63v3jtm8e6syi****",
  "VSwitchId": "vsw-2ze94pjtfuj9vaymf****",
  "Bucket": "test",
  "Path": "/demo/nas",
  "Name": "test-nas",
  "DataSource": {
    "Type": "NAS",  // NASをデータソースとして指定
    "Options": {
      "#6#server": "126c24****-tw***.cn-beijing.nas.aliyuncs.com", // NASのマウントターゲットを指定
      "#4#path": "/", // NASのパスを指定
      "#4#vers": "3", // NFSのバージョンを指定
      "#7#options": "nolock,tcp,noresvport" // マウントオプションを指定
    }
  },
  "RetentionDays": 1
}

OSS

{
  "RegionId": "cn-beijing",
  "SecurityGroupId": "sg-2ze63v3jtm8e6syi****",
  "VSwitchId": "vsw-2ze94pjtfuj9vaymf****",
  "Bucket": "test",
  "Path": "/demo/oss",
  "Name": "test-oss",
  "DataSource": {
    "Type": "OSS", // OSSをデータソースとして指定
    "Options": {
      "#6#bucket": "test-***", // OSSバケット名を指定
      "#3#url": "oss-cn-beijing-internal.aliyuncs.com", // OSSエンドポイントを指定
      "#4#path": "/test", // OSSのパスを指定
      "#9#otherOpts": "-o max_stat_cache_size=0 -o allow_other", // マウントオプションを指定
      "#7#ramRole": "<your RAM Role Name>" // RAMロール名を指定
    }
  },
  "RetentionDays": 1,
  "SourceIp": "2401:b180:1000:3:a4ba:83d6:a4ba:83d6"
}

SNAPSHOT

{
  "RegionId": "cn-beijing",
  "SecurityGroupId": "sg-2ze63v3jtm8e6syi****",
  "VSwitchId": "vsw-2ze94pjtfuj9vaymf****",
  "Bucket": "test",
  "Path": "/demo/snapshot",
  "Name": "test-snapshot",
  "DataSource": {
    "Type": "SNAPSHOT", // スナップショットをデータソースとして指定
    "Options": {
      "#10#snapshotId": "s-2zehb6jegdehec19****" // スナップショットIDを指定
    }
  },
  "RetentionDays": 1,
  "Size": 40
}

データキャッシュの管理

データキャッシュのクエリ

データキャッシュを作成した後、ステータス、バケット、バケット内の格納パスなど、データキャッシュに関する情報をクエリできます。データキャッシュが「使用可能」状態の場合、データキャッシュを使用できます。

次のいずれかの方法を使用して、データキャッシュをクエリできます。

API: DescribeDataCachesオペレーションを呼び出して、データキャッシュに関する情報をクエリできます。
コンソール: データキャッシュページで、選択したリージョン内のすべてのデータキャッシュを表示できます。データキャッシュのIDをクリックすると、データキャッシュに関する情報を表示できます。

データキャッシュの更新

「使用可能」または「更新失敗」状態のデータキャッシュの場合、バケット、データソース、保存期間、サイズを更新できます。

次のいずれかの方法を使用して、データキャッシュを更新できます。

API: UpdateDataCacheオペレーションを呼び出して、データキャッシュを更新できます。
コンソール: サポートされていません。

データキャッシュのコピー

データキャッシュはリージョン間で共有できません。データキャッシュを使用してエラスティックコンテナインスタンスを作成する場合、作成するエラスティックコンテナインスタンスがデータキャッシュと同じリージョンにない場合は、ソースリージョンからデスティネーションリージョンにデータキャッシュをコピーできます。

次のいずれかの方法を使用して、データキャッシュを別のリージョンにコピーできます。

API: CopyDataCacheオペレーションを呼び出して、データキャッシュをコピーできます。
コンソール: データキャッシュページで、コピーするデータキャッシュを見つけて、「アクション」列のコピーをクリックします。

データキャッシュの削除

重要

各データキャッシュのスナップショットが作成されます。データキャッシュを保持するには、スナップショットの料金が発生します。不要になったデータキャッシュの保存期間を指定しない場合は、データキャッシュを削除することをお勧めします。

次のいずれかの方法を使用して、データキャッシュを削除できます。

API: DeleteDataCache APIオペレーションを呼び出して、データキャッシュを削除できます。
コンソール: データキャッシュページで、削除するデータキャッシュを見つけて、「アクション」列の削除をクリックします。