Eucalyptus でのイメージの管理 (1.5.2)
最初に、このページで使用しているコマンドを実行する前に、必ず 'eucarc' ファイルを取り込むようにしてください。イメージのアップロードと登録はすべてのユーザーが行うことができますが (ただし Eucalyptus 管理者がユーザーに与えたアクセス権の制限を受けます)、カーネルまたは ramdisk のアップロードと登録は admin ユーザーだけが行える点に注意してください。
次に、以下に示す手順の説明では、Eucalyptus チームが配布している euca2ools コマンドライン・ツールを使うことを前提としています。これらのツールをまだインストールしていない場合は、インストールしてください。
1. イメージの追加
VM イメージを実行可能にするには、ユーザーと admin が Walrus にルートディスクイメージ、カーネルと ramdisk のペア (ramdisk は省略することもできます) を追加し、アップロードしたデータを Eucalyptus に登録する必要があります。ルートディスクイメージ、およびカーネルと ramdisk の Walrus への追加と Eucalyptus への登録は、3 つの EC2 コマンドを使用してそれぞれ別個に行います。次に示す例では、Eucalyptus チームが用意しているテストイメージを使用します。まずテストイメージを任意のディレクトリで展開します。
カーネルを Walrus に追加し、Eucalyptus に登録します (警告: バケット名の最後にスラッシュを付けてはいけません)。
euca-bundle-image -i <kernel file> --kernel true euca-upload-bundle -b <kernel bucket> -m /tmp/<kernel file>.manifest.xml euca-register <kernel-bucket>/<kernel file>.manifest.xml
次に、ルートファイルシステムのイメージを Walrus に追加します。
euca-bundle-image -i <vm image file> euca-upload-bundle -b <image bucket> -m /tmp/<vm image file>.manifest.xml euca-register <image bucket>/<vm image file>.manifest.xml
Eucalyptus チームが用意しているテストカーネルは ramdisk なしで起動します。管理者がカーネルと ramdisk のペアをアップロードする場合も、手順は上とほとんど変わりません。
euca-bundle-image -i <initrd file> --ramdisk true euca-upload-bundle -b <initrd bucket> -m <initrd file>.manifest.xml euca-register <initrd bucket>/<initrd file>.manifest.xml
2. インスタンスへのカーネルと ramdisk の関連付け
カーネル (と ramdisk) を VM インスタンスに関連付けるための方法は 3 つあります。
- ユーザーは、'euca-bundle-image' を実行するときに、特定のカーネルと ramdisk の識別子をイメージに関連付けることができます。
euca-bundle-image -i <vm image file> --kernel <eki-XXXXXXXX> --ramdisk <eri-XXXXXXXX>
- ユーザーは、インスタンスの実行時に、'euca-run-instances' に渡すオプションで特定のカーネルと ramdisk を選択できます。
euca-run-instances --kernel <eki-XXXXXXXX> --ramdisk <eri-XXXXXXXX> <emi-XXXXXXXX>
- 管理者は、上のいずれかのオプションでカーネルと ramdisk が指定されなかった場合に使われる、デフォルトの登録済みカーネルおよび ramdisk の識別子を設定できます。そのためには、管理インタフェース (https://your.cloud.server:8443) にログインし、［Configuration］タブをクリックして、<eki-xxxxxxxx> および (必要に応じて) <eri-xxxxxxxx> を、デフォルトとして使うカーネルと ramdisk として追加します。
3. イメージの削除
イメージを削除するには、削除するイメージの登録をあらかじめ解除しておく必要があります。
euca-deregister <emi-XXXXXXXX>
その後は、バケットに格納されているファイルを削除できます。EC2 クライアントツールをセットアップするための 'eucarc' をすでに取り込んでいる場合には、次のようにします。
euca-delete-bundle -a $EC2_ACCESS_KEY -s $EC2_SECRET_KEY --url $S3_URL -b <bucket> -p <file prefix>
イメージとバケットを削除する場合は、'--clear' オプションを追加します。
euca-delete-bundle -a $EC2_ACCESS_KEY -s $EC2_SECRET_KEY --url $S3_URL -b <bucket> -p <file prefix> --clear
実行例
次に示すのは、Xen 用 'ttylinux' イメージを使う例です。
cd $EUCALYPTUS_SRC/eucalyptus-src-deps tar zxvf euca-ttylinux.tgz euca-bundle-image -i ttylinux/vmlinuz-2.6.16.33-xen --kernel true euca-upload-bundle -b kernel-bucket -m /tmp/vmlinuz-2.6.16.33-xen.manifest.xml euca-register kernel-bucket/vmlinuz-2.6.16.33-xen.manifest.xml euca-bundle-image -i ttylinux/ttylinux.img euca-upload-bundle -b image-bucket -m /tmp/ttylinux.img.manifest.xml euca-register image-bucket/ttylinux.img.manifest.xml
次に示すのは、Eucalyptus チームが用意している Ubuntu プリパッケージ版イメージに含まれている KVM 互換のカーネルと ramdisk を使う例です (このプリパッケージ版イメージには Xen 互換のカーネルと ramdisk も含まれています)。ほかのプリパッケージ版イメージを取得するには、こちらを参照してください。
tar zxvf euca-ubuntu-9.04-x86_64.tar.gz euca-bundle-image -i euca-ubuntu-9.04-x86_64/kvm-kernel/vmlinuz-2.6.28-11-generic --kernel true euca-upload-bundle -b ubuntu-kernel-bucket -m /tmp/vmlinuz-2.6.28-11-generic.manifest.xml euca-register ubuntu-kernel-bucket/vmlinuz-2.6.28-11-generic.manifest.xml (表示された eki を $EKI に設定します) euca-bundle-image -i euca-ubuntu-9.04-x86_64/kvm-kernel/initrd.img-2.6.28-11-generic --ramdisk true euca-upload-bundle -b ubuntu-ramdisk-bucket -m /tmp/initrd.img-2.6.28-11-generic.manifest.xml euca-register ubuntu-ramdisk-bucket/initrd.img-2.6.28-11-generic.manifest.xml (表示された eri を $ERI に設定します) euca-bundle-image -i euca-ubuntu-9.04-x86_64/ubuntu.9-04.x86-64.img --kernel $EKI --ramdisk $ERI euca-upload-bundle -b ubuntu-image-bucket -m /tmp/ubuntu.9-04.x86-64.img.manifest.xml euca-register ubuntu-image-bucket/ubuntu.9-04.x86-64.img.manifest.xml
これで、新しくアップロードされたイメージを使用できる準備が整ったことになります (Eucalyptus の使い方の詳細については、「ユーザーガイド」を参照してください)。
「管理者ガイド」に戻る
「Eucalyptus の管理」に進む