View a markdown version of this page

Tutorial: Membuat IPAM dan kolam menggunakan AWS CLI - Amazon Virtual Private Cloud
Langkah 1: Aktifkan IPAM di organisasi AndaLangkah 2: Buat IPAMLangkah 3: Buat kumpulan alamat IPv4Langkah 4: Menyediakan CIDR ke pool tingkat atasLangkah 5. Buat kumpulan Regional dengan CIDR yang bersumber dari kumpulan tingkat atasLangkah 6: Menyediakan CIDR ke kolam RegionalLangkah 7. Buat berbagi RAM untuk mengaktifkan penugasan IP di seluruh akunLangkah 8. Buat VPCLangkah 9. Pembersihan

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Tutorial: Membuat IPAM dan kolam menggunakan AWS CLI

Ikuti langkah-langkah dalam tutorial ini untuk menggunakan untuk membuat IPAM, membuat kumpulan alamat IP, dan mengalokasikan VPC dengan CIDR dari kumpulan IPAM. AWS CLI

Berikut ini adalah contoh hierarki struktur kumpulan yang akan Anda buat dengan mengikuti langkah-langkah di bagian ini:

  • IPAM beroperasi di Wil AWS ayah 1, Wil AWS ayah 2

    • Lingkup pribadi

      • Top-level kolam

        • Kolam regional di AWS Wilayah 2

          • Kolam pengembangan

            • Alokasi untuk VPC

catatan

Di bagian ini, Anda akan membuat IPAM. Secara default, Anda hanya dapat membuat satu IPAM. Untuk informasi selengkapnya, lihat Kuota untuk IPAM Anda. Jika Anda telah mendelegasikan akun IPAM dan membuat IPAM, Anda dapat melewati langkah 1 dan 2.

Langkah 1: Aktifkan IPAM di organisasi Anda

Langkah ini bersifat opsional. Selesaikan langkah ini untuk mengaktifkan IPAM di organisasi Anda dan mengonfigurasi IPAM yang didelegasikan menggunakan CLI. AWS Untuk informasi selengkapnya tentang peran akun IPAM, lihatIntegrasikan IPAM dengan akun di AWS Organisasi.

Permintaan ini harus dibuat dari akun manajemen AWS Organisasi. Saat menjalankan perintah berikut, pastikan Anda menggunakan peran dengan kebijakan IAM yang mengizinkan tindakan berikut:

  • ec2:EnableIpamOrganizationAdminAccount

  • organizations:EnableAwsServiceAccess

  • organizations:RegisterDelegatedAdministrator

  • iam:CreateServiceLinkedRole

aws ec2 enable-ipam-organization-admin-account --region us-east-1 --delegated-admin-account-id 11111111111

Anda akan melihat output berikut, menunjukkan bahwa pengaktifan berhasil. 

{
    "Success": true
}

Langkah 2: Buat IPAM

Ikuti langkah-langkah di bagian ini untuk membuat IPAM dan melihat informasi tambahan tentang cakupan yang dibuat. Anda akan menggunakan IPAM ini saat membuat kumpulan dan menyediakan rentang alamat IP untuk kumpulan tersebut di langkah selanjutnya.

catatan

Opsi Wilayah operasi menentukan Wil AWS ayah mana yang dapat digunakan untuk kumpulan IPAM. Untuk informasi selengkapnya tentang mengoperasikan Wilayah, lihatBuat IPAM.

Untuk membuat IPAM menggunakan AWS CLI

  1. Jalankan perintah berikut untuk membuat instance IPAM.

    aws ec2 create-ipam --description my-ipam --region us-east-1 --operating-regions RegionName=us-west-2

    Saat Anda membuat IPAM, AWS secara otomatis melakukan hal berikut:

    • Mengembalikan ID sumber daya unik global (IpamId) untuk IPAM.

    • Membuat ruang lingkup publik default (PublicDefaultScopeId) dan ruang lingkup pribadi default (PrivateDefaultScopeId).

    {                                                                                      
    "Ipam": {
        "OwnerId": "123456789012",
        "IpamId": "ipam-0de83dba6694560a9",
        "IpamArn": "arn:aws:ec2::123456789012:ipam/ipam-0de83dba6694560a9",
        "PublicDefaultScopeId": "ipam-scope-02a24107598e982c5",
        "PrivateDefaultScopeId": "ipam-scope-065e7dfe880df679c",
        "ScopeCount": 2,
        "Description": "my-ipam",
        "OperatingRegions": [
            {
                "RegionName": "us-west-2"
            },
            {
                "RegionName": "us-east-1"
            }
        ],
        "Tags": []
    }
}

  2. Jalankan perintah berikut untuk melihat informasi tambahan yang terkait dengan cakupan. Ruang lingkup publik ditujukan untuk alamat IP yang akan diakses melalui internet publik. Cakupan pribadi ditujukan untuk alamat IP yang tidak akan diakses melalui internet publik.

    aws ec2 describe-ipam-scopes --region us-east-1

    Dalam output, Anda melihat cakupan yang tersedia. Anda akan menggunakan ID cakupan pribadi di langkah berikutnya.

    {
    "IpamScopes": [
        {
            "OwnerId": "123456789012",
            "IpamScopeId": "ipam-scope-02a24107598e982c5",
            "IpamScopeArn": "arn:aws:ec2::123456789012:ipam-scope/ipam-scope-02a24107598e982c5",
            "IpamArn": "arn:aws:ec2::123456789012:ipam/ipam-0de83dba6694560a9",
            "IpamScopeType": "public",
            "IsDefault": true,
            "PoolCount": 0
        },
        {
            "OwnerId": "123456789012",
            "IpamScopeId": "ipam-scope-065e7dfe880df679c",
            "IpamScopeArn": "arn:aws:ec2::123456789012:ipam-scope/ipam-scope-065e7dfe880df679c",
            "IpamArn": "arn:aws:ec2::123456789012:ipam/ipam-0de83dba6694560a9",
            "IpamScopeType": "private",
            "IsDefault": true,
            "PoolCount": 0
        }
    ]
}

Langkah 3: Buat kumpulan alamat IPv4

Ikuti langkah-langkah di bagian ini untuk membuat kumpulan alamat IPv4.

penting

Anda tidak akan menggunakan --locale opsi di kumpulan tingkat atas ini. Anda akan mengatur opsi lokal nanti di kumpulan Regional. Lokalnya adalah Wilayah AWS tempat Anda ingin kumpulan tersedia untuk alokasi CIDR. Sebagai akibat dari tidak menyetel lokal pada kumpulan tingkat atas, lokal akan default keNone. Jika kumpulan memiliki lokalNone, kumpulan tidak akan tersedia untuk sumber daya VPC di Wilayah mana pun AWS . Anda hanya dapat mengalokasikan ruang alamat IP secara manual di kolam untuk memesan ruang.

Untuk membuat kumpulan alamat IPv4 untuk semua AWS sumber daya menggunakan AWS CLI

  1. Jalankan perintah berikut untuk membuat kumpulan alamat IPv4. Gunakan ID cakupan pribadi IPAM yang Anda buat pada langkah sebelumnya.

    aws ec2 create-ipam-pool --ipam-scope-id ipam-scope-065e7dfe880df679c --description "top-level-pool" --address-family ipv4

    Pada output, Anda akan melihat status create-in-progress untuk kolam.

    {
    "IpamPool": {
        "OwnerId": "123456789012",
        "IpamPoolId": "ipam-pool-0008f25d7187a08d9",
        "IpamPoolArn": "arn:aws:ec2::123456789012:ipam-pool/ipam-pool-0008f25d7187a08d9",
        "IpamScopeArn": "arn:aws:ec2::123456789012:ipam-scope/ipam-scope-065e7dfe880df679c",
        "IpamScopeType": "private",
        "IpamArn": "arn:aws:ec2::123456789012:ipam/ipam-0de83dba6694560a9",
        "Locale": "None",
        "PoolDepth": 1,
        "State": "create-in-progress",
        "Description": "top-level-pool",
        "AutoImport": false,
        "AddressFamily": "ipv4",
        "Tags": []
    }
}

  2. Jalankan perintah berikut sampai Anda melihat status create-complete di output.

    aws ec2 describe-ipam-pools

    Contoh output berikut menunjukkan status yang benar.

    {
    "IpamPools": [
        {
            "OwnerId": "123456789012",
            "IpamPoolId": "ipam-pool-0008f25d7187a08d9",
            "IpamPoolArn": "arn:aws:ec2::123456789012:ipam-pool/ipam-pool-0008f25d7187a08d9",
            "IpamScopeArn": "arn:aws:ec2::123456789012:ipam-scope/ipam-scope-065e7dfe880df679c",
            "IpamScopeType": "private",
            "IpamArn": "arn:aws:ec2::123456789012:ipam/ipam-0de83dba6694560a9",
            "Locale": "None",
            "PoolDepth": 1,
            "State": "create-complete",
            "Description": "top-level-pool",
            "AutoImport": false,
            "AddressFamily": "ipv4"
        }
    ]
}

Langkah 4: Menyediakan CIDR ke pool tingkat atas

Ikuti langkah-langkah di bagian ini untuk menyediakan CIDR ke kumpulan tingkat atas, lalu verifikasi bahwa CIDR disediakan. Untuk informasi selengkapnya, lihat Penyediaan CIDR ke kolam.

Untuk menyediakan blok CIDR ke kolam menggunakan AWS CLI

  1. Jalankan perintah berikut untuk menyediakan CIDR.

    aws ec2 provision-ipam-pool-cidr --region us-east-1 --ipam-pool-id ipam-pool-0008f25d7187a08d9 --cidr 10.0.0.0/8

    Dalam output, Anda dapat memverifikasi status penyediaan.

    {
    "IpamPoolCidr": {                     
        "Cidr": "10.0.0.0/8",        
        "State": "pending-provision"      
    }                                     
}

  2. Jalankan perintah berikut sampai Anda melihat status provisioned di output.

    aws ec2 get-ipam-pool-cidrs --region us-east-1 --ipam-pool-id ipam-pool-0008f25d7187a08d9

    Contoh output berikut menunjukkan status yang benar.

    {
    "IpamPoolCidrs": [                     
        {                                  
            "Cidr": "10.0.0.0/8",     
            "State": "provisioned"         
        }                                  
    ]                                      
}

Langkah 5. Buat kumpulan Regional dengan CIDR yang bersumber dari kumpulan tingkat atas

Saat Anda membuat kumpulan IPAM, kumpulan tersebut milik Wil AWS ayah IPAM secara default. Saat Anda membuat VPC, kumpulan yang diambil VPC harus berada di Wilayah yang sama dengan VPC. Anda dapat menggunakan --locale opsi saat membuat kumpulan untuk membuat kumpulan tersedia untuk layanan di Wilayah selain Wilayah IPAM. Ikuti langkah-langkah di bagian ini untuk membuat kumpulan Regional di lokal lain.

Untuk membuat kolam dengan CIDR yang bersumber dari kumpulan sebelumnya menggunakan AWS CLI

  1. Jalankan perintah berikut untuk membuat kumpulan dan memasukkan ruang dengan CIDR yang diketahui tersedia dari kumpulan sebelumnya.

    aws ec2 create-ipam-pool --description "regional--pool" --region us-east-1 --ipam-scope-id ipam-scope-065e7dfe880df679c --source-ipam-pool-id 
ipam-pool-0008f25d7187a08d9 --locale us-west-2 --address-family ipv4

    Pada output, Anda akan melihat ID kumpulan yang Anda buat. Anda akan memerlukan ID ini di langkah berikutnya.

    {
    "IpamPool": {
        "OwnerId": "123456789012",
        "IpamPoolId": "ipam-pool-0da89c821626f1e4b",
        "SourceIpamPoolId": "ipam-pool-0008f25d7187a08d9",
        "IpamPoolArn": "arn:aws:ec2::123456789012:ipam-pool/ipam-pool-0da89c821626f1e4b",
        "IpamScopeArn": "arn:aws:ec2::123456789012:ipam-scope/ipam-scope-065e7dfe880df679c",
        "IpamScopeType": "private",
        "IpamArn": "arn:aws:ec2::123456789012:ipam/ipam-0de83dba6694560a9",
        "Locale": "us-west-2",
        "PoolDepth": 2,
        "State": "create-in-progress",
        "Description": "regional--pool",
        "AutoImport": false,
        "AddressFamily": "ipv4",
        "Tags": []
    }
}

  2. Jalankan perintah berikut sampai Anda melihat status create-complete di output.

    aws ec2 describe-ipam-pools

    Pada output, Anda melihat kumpulan yang Anda miliki di IPAM Anda. Dalam tutorial ini, kami membuat kumpulan tingkat atas dan Regional, sehingga Anda akan melihat keduanya.

    {
    "IpamPools": [
        {
            "OwnerId": "123456789012",
            "IpamPoolId": "ipam-pool-0008f25d7187a08d9",
            "IpamPoolArn": "arn:aws:ec2::123456789012:ipam-pool/ipam-pool-0008f25d7187a08d9",
            "IpamScopeArn": "arn:aws:ec2::123456789012:ipam-scope/ipam-scope-065e7dfe880df679c",
            "IpamScopeType": "private",
            "IpamArn": "arn:aws:ec2::123456789012:ipam/ipam-0de83dba6694560a9",
            "Locale": "None",
            "PoolDepth": 1,
            "State": "create-complete",
            "Description": "top-level-pool",
            "AutoImport": false,
            "AddressFamily": "ipv4"
        },
        {
            "OwnerId": "123456789012",
            "IpamPoolId": "ipam-pool-0da89c821626f1e4b",
            "SourceIpamPoolId": "ipam-pool-0008f25d7187a08d9",
            "IpamPoolArn": "arn:aws:ec2::123456789012:ipam-pool/ipam-pool-0da89c821626f1e4b",
            "IpamScopeArn": "arn:aws:ec2::123456789012:ipam-scope/ipam-scope-065e7dfe880df679c",
            "IpamScopeType": "private",
            "IpamArn": "arn:aws:ec2::123456789012:ipam/ipam-0de83dba6694560a9",
            "Locale": "us-west-2",
            "PoolDepth": 2,
            "State": "create-complete",
            "Description": "regional--pool",
            "AutoImport": false,
            "AddressFamily": "ipv4"
        }
    ]
}

Langkah 6: Menyediakan CIDR ke kolam Regional

Ikuti langkah-langkah di bagian ini untuk menetapkan blok CIDR ke kumpulan, dan memvalidasi bahwa blok tersebut telah berhasil disediakan.

Untuk menetapkan blok CIDR ke kumpulan Regional menggunakan AWS CLI

  1. Jalankan perintah berikut untuk menyediakan CIDR.

    aws ec2 provision-ipam-pool-cidr --region us-east-1 --ipam-pool-id ipam-pool-0da89c821626f1e4b --cidr 10.0.0.0/16

    Dalam output, Anda melihat keadaan kolam.

    {
    "IpamPoolCidr": {                     
        "Cidr": "10.0.0.0/16",       
        "State": "pending-provision"      
    }                                     
}

  2. Jalankan perintah berikut sampai Anda melihat status provisioned di output.

    aws ec2 get-ipam-pool-cidrs --region us-east-1 --ipam-pool-id ipam-pool-0da89c821626f1e4b

    Contoh output berikut menunjukkan status yang benar.

    {
    "IpamPoolCidrs": [                     
        {                                  
            "Cidr": "10.0.0.0/16",     
            "State": "provisioned"         
        }                                  
    ]                                      
}

  3. Jalankan perintah berikut untuk menanyakan kumpulan tingkat atas untuk melihat alokasi. Kumpulan Regional dianggap sebagai alokasi dalam kumpulan tingkat atas.

    aws ec2 get-ipam-pool-allocations --region us-east-1 --ipam-pool-id ipam-pool-0008f25d7187a08d9

    Pada output, Anda melihat kumpulan Regional sebagai alokasi di kumpulan tingkat atas.

    {
    "IpamPoolAllocations": [
        {
            "Cidr": "10.0.0.0/16",
            "IpamPoolAllocationId": "ipam-pool-alloc-fbd525f6c2bf4e77a75690fc2d93479a",
            "ResourceId": "ipam-pool-0da89c821626f1e4b",
            "ResourceType": "ipam-pool",
            "ResourceOwner": "123456789012"
        }
    ]
}

Langkah 7. Buat berbagi RAM untuk mengaktifkan penugasan IP di seluruh akun

Langkah ini bersifat opsional. Anda dapat menyelesaikan langkah ini hanya jika Anda selesaiIntegrasikan IPAM dengan akun di AWS Organisasi.

Saat Anda membuat berbagi AWS RAM kumpulan IPAM, ini memungkinkan penetapan IP di seluruh akun. Berbagi RAM hanya tersedia di Wil AWS ayah rumah Anda. Perhatikan bahwa Anda membuat berbagi ini di Wilayah yang sama dengan IPAM, bukan di Wilayah lokal untuk kumpulan. Semua operasi administratif pada sumber daya IPAM dilakukan melalui Wilayah asal IPAM Anda. Contoh dalam tutorial ini membuat satu share untuk satu kumpulan, tetapi Anda dapat menambahkan beberapa kumpulan ke satu berbagi. Untuk informasi lebih lanjut, termasuk penjelasan tentang opsi yang harus Anda masukkan, lihatBagikan kumpulan IPAM menggunakan AWS RAM.

Jalankan perintah berikut untuk membuat berbagi sumber daya.

aws ram create-resource-share --region us-east-1 --name pool_share --resource-arns arn:aws:ec2::123456789012:ipam-pool/ipam-pool-0dec9695bca83e606 --principals 123456

Outputnya menunjukkan bahwa kolam telah dibuat.

{
    "resourceShare": {
        "resourceShareArn": "arn:aws:ram:us-west-2:123456789012:resource-share/3ab63985-99d9-1cd2-7d24-75e93EXAMPLE",
        "name": "pool_share",
        "owningAccountId": "123456789012",
        "allowExternalPrincipals": false,
        "status": "ACTIVE",
        "creationTime": 1565295733.282,
        "lastUpdatedTime": 1565295733.282
    }
}

Langkah 8. Buat VPC

Jalankan perintah berikut untuk membuat VPC dan menetapkan blok CIDR ke VPC dari kumpulan di IPAM yang baru dibuat.

aws ec2 create-vpc --region us-east-1 --ipv4-ipam-pool-id ipam-pool-04111dca0d960186e --cidr-block 10.0.0.0/24

Output menunjukkan bahwa VPC telah dibuat.

{
    "Vpc": {
        "CidrBlock": "10.0.0.0/24",
        "DhcpOptionsId": "dopt-19edf471",
        "State": "pending",
        "VpcId": "vpc-0983f3c454f3d8be5",
        "OwnerId": "123456789012",   
        "InstanceTenancy": "default",
        "Ipv6CidrBlockAssociationSet": [],
        "CidrBlockAssociationSet": [
            {
                "AssociationId": "vpc-cidr-assoc-00b24cc1c2EXAMPLE",
                "CidrBlock": "10.0.0.0/24",
                "CidrBlockState": {
                    "State": "associated"
                }
            }
        ],
        "IsDefault": false
    }
}

Langkah 9. Pembersihan

Ikuti langkah-langkah di bagian ini untuk menghapus sumber daya IPAM yang telah Anda buat dalam tutorial ini.

  1. Hapus VPC.

    aws ec2 delete-vpc --vpc-id vpc-0983f3c454f3d8be5

  2. Hapus berbagi RAM kolam IPAM.

    aws ram delete-resource-share --resource-share-arn arn:aws:ram:us-west-2:123456789012:resource-share/3ab63985-99d9-1cd2-7d24-75e93EXAMPLE

  3. Depenyediaan kumpulan CIDR dari kolam Regional.

     aws ec2 deprovision-ipam-pool-cidr --ipam-pool-id ipam-pool-0da89c821626f1e4b --region us-east-1

  4. Depenyediaan kolam CIDR dari kumpulan tingkat atas.

     aws ec2 deprovision-ipam-pool-cidr --ipam-pool-id ipam-pool-0008f25d7187a08d9 --region us-east-1

  5. Hapus IPAM

    aws ec2 delete-ipam --region us-east-1