Menyimpan metadata pada drive konfigurasi.¶

Persyaratan dan pedoman¶

Untuk menggunakan drive konfigurasi, Anda harus mengikuti persyaratan berikut untuk host dan image komputasi

Compute host requirements (Persyaratan host Compute)

• Hypervisors berikut mendukung drive konfigurasi: libvirt, XenServer, Hyper-V, dan VMware.

  Juga, layanan Bare Metal mendukung drive konfigurasi.

• Untuk menggunakan drive konfigurasi dengan libvirt, XenServer, atau VMware, Anda harus menginstal paket genisoimage pada setiap host komputasi. Jika tidak, instance tidak boot dengan benar.

  Gunakan flag mkisofs_cmd` untuk mengatur jalan dimana Anda menginstal program genisoimage. Jika genisoimage berada di jalur yang sama dengan layanan nova-compute, Anda tidak perlu mengatur bendera (flag) ini.

• Untuk menggunakan drive konfigurasi dengan Hyper-V, Anda harus mengatur nilai mkisofs_cmd ke path lengkap ke instalasi mkisofs.exe. Selain itu, Anda harus mengatur nilai qemu_img_cmd di bagian konfigurasi `` hyperv`` ke path lengkap ke instalasi perintah qemu-img.

• Untuk menggunakan drive konfigurasi dengan layanan Bare Metal, Anda tidak perlu mempersiapkan apa-apa karena layanan Bare Metal memperlakukan drive konfigurasi benar.

Image requirements (persyaratan image)

• Image yang dibuat dengan versi terbaru dari paket cloud-init secara otomatis dapat mengakses metadata melewati drive konfigurasi. Tabel berikut mencantumkan referensi untuk versi cloud-init yang dipetakan ke sistem operasi tertentu:

  Sistem operasi	Referensi untuk versi cloud-init
  Ubuntu	http://packages.ubuntu.com/search?keywords=cloud-init
  Fedora (RHEL)	https://www.rpmfind.net/linux/rpm2html/search.php?query=cloud-init
  openSUSE (SLE)	http://software.opensuse.org/download.html?project=Cloud%3ATools&package=cloud-init

• Jika image tidak memiliki paket cloud-init terinstal, Anda harus menyesuaikan image untuk menjalankan script yang me-mount drive konfigurasi pada boot, membaca data dari drive, dan mengambil tindakan yang tepat seperti menambahkan kunci publik (public key) ke akun . Anda dapat membaca lebih detail tentang bagaimana data diorganisasi pada drive konfigurasi.

• Jika Anda menggunakan Xen dengan konfigurasi drive, gunakan parameter konfigurasi xenapi_disable_agent untuk menonaktifkan agen.

Guidelines (pedoman)

• Jangan mengandalkan kehadiran metadata EC2 di drive konfigurasi, karena konten ini mungkin dihapus di masa mendatang. Misalnya, tidak bergantung pada file dalam direktori ec2.
• Bila Anda membuat image yang mengakses drive data konfigurasi dan beberapa direktori berada di bawah direktori openstack, selalu pilih versi API tertinggi pada tanggal tersebut konsumen Anda mendukung. Misalnya, jika image guest Anda mendukung 2012/03/05, 2012/08/05, dan 2013/04/13 versi, cobalah petram 2013/04/13 dan jatuh kembali ke versi sebelumnya jika 2013/04/13 adalah tidak hadir.

Mengaktifkan dan mengakses drive konfigurasi¶

1. Untuk mengaktifkan drive konfigurasi, lewatkan parameter --config-drive true ke perintah openstack server create.

   Contoh berikut memungkinkan drive konfigurasi dan melewati data pengguna, dua file, dan dua kunci/nilai metadata pasangan (key/value metadata pair), yang semuanya dapat diakses dari drive konfigurasi:

   $ openstack server create --config-drive true --image my-image-name \
     --flavor 1 --key-name mykey --user-data ./my-user-data.txt \
     --file /etc/network/interfaces=/home/myuser/instance-interfaces \
     --file known_hosts=/home/myuser/.ssh/known_hosts \
     --property role=webservers --property essential=false MYINSTANCE
   

   Anda juga dapat mengkonfigurasi layanan Compute untuk selalu membuat drive konfigurasi dengan menetapkan opsi berikut di file /etc/nova/nova.conf:

   force_config_drive = true
   

   Catatan

   Jika pengguna melewatkan bendera (flag) --config-drive true ke perintah nova boot, administrator tidak dapat menonaktifkan drive konfigurasi.

2. Jika sistem operasi guest Anda mendukung mengakses disk dengan label, Anda dapat me-mount drive konfigurasi sebagai perangkat /dev/disk/by-label/configurationDriveVolumeLabel. Pada contoh berikut, drive konfigurasi memiliki label volume config-2:

   # mkdir -p /mnt/config
   # mount /dev/disk/by-label/config-2 /mnt/config
   

# blkid -t LABEL="config-2" -odevice

/dev/vdb

# mkdir -p /mnt/config
# mount /dev/vdb /mnt/config

ec2/2009-04-04/meta-data.json
ec2/2009-04-04/user-data
ec2/latest/meta-data.json
ec2/latest/user-data
openstack/2012-08-10/meta_data.json
openstack/2012-08-10/user_data
openstack/content
openstack/content/0000
openstack/content/0001
openstack/latest/meta_data.json
openstack/latest/user_data

{
    "availability_zone": "nova",
    "files": [
        {
            "content_path": "/content/0000",
            "path": "/etc/network/interfaces"
        },
        {
            "content_path": "/content/0001",
            "path": "known_hosts"
        }
    ],
    "hostname": "test.novalocal",
    "launch_index": 0,
    "name": "test",
    "meta": {
        "role": "webservers",
        "essential": "false"
    },
    "public_keys": {
        "mykey": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgQDBqUfVvCSez0/Wfpd8dLLgZXV9GtXQ7hnMN+Z0OWQUyebVEHey1CXuin0uY1cAJMhUq8j98SiW+cU0sU4J3x5l2+xi1bodDm1BtFWVeLIOQINpfV1n8fKjHB+ynPpe1F6tMDvrFGUlJs44t30BrujMXBe8Rq44cCk6wqyjATA3rQ== Generated by Nova\n"
    },
    "uuid": "83679162-1378-4288-a2d4-70e13ec132aa"
}

{
    "ami-id": "ami-00000001",
    "ami-launch-index": 0,
    "ami-manifest-path": "FIXME",
    "block-device-mapping": {
        "ami": "sda1",
        "ephemeral0": "sda2",
        "root": "/dev/sda1",
        "swap": "sda3"
    },
    "hostname": "test.novalocal",
    "instance-action": "none",
    "instance-id": "i-00000001",
    "instance-type": "m1.tiny",
    "kernel-id": "aki-00000002",
    "local-hostname": "test.novalocal",
    "local-ipv4": null,
    "placement": {
        "availability-zone": "nova"
    },
    "public-hostname": "test.novalocal",
    "public-ipv4": "",
    "public-keys": {
        "0": {
            "openssh-key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgQDBqUfVvCSez0/Wfpd8dLLgZXV9GtXQ7hnMN+Z0OWQUyebVEHey1CXuin0uY1cAJMhUq8j98SiW+cU0sU4J3x5l2+xi1bodDm1BtFWVeLIOQINpfV1n8fKjHB+ynPpe1F6tMDvrFGUlJs44t30BrujMXBe8Rq44cCk6wqyjATA3rQ== Generated by Nova\n"
        }
    },
    "ramdisk-id": "ari-00000003",
    "reservation-id": "r-7lfps8wj",
    "security-groups": [
        "default"
    ]
}

config_drive_format=iso9660

config_drive_cdrom=true

config_drive_format=vfat