Elastic Compute Service:ImportImage

操作の説明

この操作を呼び出す際は、以下の項目に注意してください:

• 事前にイメージファイルを Object Storage サービス (OSS) にアップロードする必要があります。詳細については、ファイルのアップロードを参照してください。

• 一部のサーバー、仮想マシン、またはクラウドホストのオペレーティングシステムの問題により、インポートされたカスタムイメージから作成された ECS インスタンスが起動に失敗するのを防ぐため、イメージをインポートする前にソースサーバーに virtio ドライバーをインストールする必要があるかどうかを確認してください。詳細については、virtio ドライバーのインストールを参照してください。

• 初めてイメージをインポートする場合、Resource Access Management (RAM) を使用して ECS に OSS バケットへのアクセスを権限付与する必要があります。権限付与しない場合、NoSetRoletoECSServiceAccount または InvalidOperation.CloudBoxImageImportRoleRequired エラーが返されます。以下の 2 つのシナリオがあります:

  • CloudBox を使用せずにイメージファイルをインポートする場合: RAM コンソールでワンクリックで RAM 認可を完了できます。詳細については、クラウドリソースアクセス権限付与を参照してください。手動で RAM 認可を完了することもできます。一部の操作には以下のポリシーと権限が必須です。詳細については、アカウントのアクセスの制御を参照してください。

    1. AliyunECSImageImportDefaultRole という名前のロールを作成します。この正確な名前を使用する必要があります。そうしないと、イメージのインポートが失敗します。ロールには以下のポリシーを使用してください:

       {
       	"Statement": [
       	{
       		"Action": "sts:AssumeRole",
       		"Effect": "Allow",
       		"Principal": {
       		"Service": [
       			"ecs.aliyuncs.com"
       		]
       		}
       	}
       ],
       	"Version": "1"
       }
       

    2. システムポリシー AliyunECSImageImportRolePolicy をロールにアタッチします。以下の権限を含むカスタムポリシーを作成することもできます:

       {
       	"Version": "1",
       	"Statement": [
       	{
       		"Action": [
       				"oss:GetObject",
       				"oss:GetBucketLocation",
       				"oss:GetBucketInfo"
       	],
       			"Resource": "*",
       			"Effect": "Allow"
       			}
       	]
       }
       
       

  • CloudBox を使用してイメージファイルをインポートする場合: RAM コンソールでワンクリックで RAM 認可を完了できます。詳細については、クラウドリソースアクセス権限付与を参照してください。手動で RAM 認可を完了することもできます。一部の操作には以下のポリシーと権限が必須です。詳細については、アカウントのアクセスの制御を参照してください。

    1. AliyunECSCloudBoxImageImportDefaultRole という名前のロールを作成します。この正確な名前を使用する必要があります。そうしないと、イメージのインポートが失敗します。ロールには以下のポリシーを使用してください:

       {
       	"Statement": [
       	{
       		"Action": "sts:AssumeRole",
       		"Effect": "Allow",
       		"Principal": {
       		"Service": [
       			"ecs.aliyuncs.com"
       		]
       		}
       	}
       ],
       	"Version": "1"
       }
       

    2. システムポリシー AliyunECSCloudBoxImageImportRolePolicy をロールにアタッチします。以下の権限を含むカスタムポリシーを作成することもできます:

       {
       	"Version": "1",
       	"Statement": [
       	{
       		"Action": [
       				"oss-cloudbox:GetObject",
       				"oss-cloudbox:GetBucketLocation",
       				"oss-cloudbox:GetBucketInfo"
       	],
       			"Resource": "*",
       			"Effect": "Allow"
       			}
       	]
       }
       
       

• インポート中のイメージは削除できません。 CancelTask を呼び出してイメージのインポートタスクをキャンセルすることのみ可能です。

• イメージをインポートするリージョンは、イメージファイルがアップロードされた OSS バケットのリージョンと同じである必要があります。

• DiskDeviceMapping.N パラメーターの N の有効な値: 1 ～ 17。N が 1 の場合、ディスクはシステムディスクです。N が 2 ～ 17 の場合、ディスクはデータディスクです。N が 17 より大きい場合、システムはその値を自動的に無視します。

• Architecture パラメーターが arm64 にセットされている場合、または Platform パラメーターが CentOS Stream、Anolis、AlmaLinux、UOS、Kylin、Rocky Linux にセットされている場合は、以下の項目に注意してください:

  • インポートされたイメージがパスワード構成またはキーペアの変更をサポートするようにするには、イメージが以下の要件を満たす必要があります:

    • オペレーティングシステムのカーネルが CONFIG_FW_CFG_SYSFS 特徴をサポートしている必要があります。バージョン 4.6 より後の Linux コミュニティカーネルはデフォルトでこの特徴をサポートしています。バージョン 3.10.0-826.el7 より後の CentOS カーネルはデフォルトでこの特徴をサポートしています。イメージに対応するサーバーで grep -nr CONFIG_FW_CFG_SYSFS /boot/config-$(uname -r) コマンドを実行できます。出力に CONFIG_FW_CFG_SYSFS=y が含まれている場合、イメージのカーネルは CONFIG_FW_CFG_SYSFS 特徴をサポートしています。

    • 最新バージョンの Alibaba Cloud cloud-init がオペレーティングシステムにインストールされている必要があります。Cloud-init 19.1 はバージョン 19.1.3 以降である必要があります。一部の古いオペレーティングシステムの Cloud-init 0.7.6a はバージョン 0.7.6a15 以降である必要があります。詳細については、cloud-init のインストールを参照してください。

    • オペレーティングシステムが SHA-512 暗号化アルゴリズムをサポートしている必要があります。

  • インポートされたイメージがディスクのサイズ変更とファイルシステムのサイズ変更をサポートするようにするには、イメージが以下の要件を満たす必要があります:

    • オペレーティングシステムのカーネルバージョンが 3.6 より後である必要があります。

    • growpart コマンドがサポートされている必要があります。このコマンドをサポートするには、cloud-utils-growpart パッケージをインストールしてください。インストールメソッドはオペレーティングシステムによって異なります。詳細については、パーティションとファイルシステムのサイズ変更 (Linux)を参照してください。

    • resize2fs コマンドがサポートされている必要があります。このコマンドをサポートするには、e2fsprogs パッケージをインストールしてください。このパッケージはオペレーティングシステムにデフォルトでインストールされています。インストールされていない場合は、手動でインストールしてください。

    • 最新バージョンの Alibaba Cloud cloud-init がオペレーティングシステムにインストールされている必要があります。Cloud-init 19.1 はバージョン 19.1.3 以降である必要があります。一部の古いオペレーティングシステムの Cloud-init 0.7.6a はバージョン 0.7.6a15 以降である必要があります。詳細については、cloud-init のインストールを参照してください。

• インポートするカスタムイメージのシステムアーキテクチャーが arm64 の場合、RTC 時計を協定世界時 (UTC) 標準を使用するように構成してください。詳細については、Linux の時間とタイムゾーンの説明を参照してください。

• イメージをインポートする際にイメージ検出パラメーターを構成してください。これにより、システムがイメージを最適化できます。詳細については、イメージ検出の概要を参照してください。