Memulai menggunakan AWS CLI - CodeArtifact

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

Memulai menggunakan AWS CLI

Jalankan langkah-langkah berikut untuk memulai CodeArtifact menggunakan AWS Command Line Interface (AWS CLI). Untuk informasi selengkapnya, lihat Menginstal atau meningkatkan dan kemudian mengonfigurasi AWS CLI. Panduan ini menggunakan manajer paket npm, jika Anda menggunakan manajer paket yang berbeda, Anda perlu memodifikasi beberapa langkah berikut.

  1. Gunakan AWS CLI untuk menjalankan create-domain perintah. 

    aws codeartifact create-domain --domain my-domain

    Data berformat JSON muncul dalam output dengan detail tentang domain baru Anda. 

    {
    "domain": {
        "name": "my-domain",
        "owner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:domain/my-domain",
        "status": "Active",
        "createdTime": "2020-10-07T15:36:35.194000-04:00",
        "encryptionKey": "arn:aws:kms:us-west-2:111122223333:key/your-kms-key",
        "repositoryCount": 0,
        "assetSizeBytes": 0
    }
}

    Jika Anda menerima kesalahanCould not connect to the endpoint URL, pastikan bahwa Anda telah AWS CLI dikonfigurasi dan nama wilayah Default Anda disetel ke Wilayah yang sama tempat Anda membuat repositori, lihat Mengonfigurasi Antarmuka Baris Perintah AWS.

  2. Gunakan perintah create-repository untuk membuat repositori di domain Anda.

    aws codeartifact create-repository --domain my-domain --domain-owner 111122223333 --repository my-repo

    Data berformat JSON muncul dalam output dengan detail tentang repositori baru Anda. 

    {
    "repository": {
        "name": "my-repo",
        "administratorAccount": "111122223333",
        "domainName": "my-domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/my-repo",
        "upstreams": [],
        "externalConnections": []
    }
}

  3. Gunakan perintah create-repository untuk membuat repositori hulu untuk repositori my-repo Anda.

    aws codeartifact create-repository --domain my-domain --domain-owner 111122223333 --repository npm-store

    Data berformat JSON muncul dalam output dengan detail tentang repositori baru Anda.

    {
    "repository": {
        "name": "npm-store",
        "administratorAccount": "111122223333",
        "domainName": "my-domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/npm-store",
        "upstreams": [],
        "externalConnections": []
    }
}

  4. Gunakan perintah associate-external-connection untuk menambahkan koneksi eksternal ke repositori publik npm ke repositori npm-store. 

    aws codeartifact associate-external-connection --domain my-domain --domain-owner 111122223333 --repository npm-store --external-connection "public:npmjs"

    Data berformat JSON muncul dalam output dengan detail tentang repositori dan koneksi eksternalnya yang baru.

    {
    "repository": {
        "name": "npm-store",
        "administratorAccount": "111122223333",
        "domainName": "my-domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/npm-store",
        "upstreams": [],
        "externalConnections": [
            {
                "externalConnectionName": "public:npmjs",
                "packageFormat": "npm",
                "status": "AVAILABLE"
            }
        ]
    }
}

    Untuk informasi selengkapnya, lihat Connect CodeArtifact repositori ke repositori publik.

  5. Gunakan perintah update-repository untuk mengaitkan repositori npm-store sebagai repositori hulu ke repositori my-repo. 

    aws codeartifact update-repository --repository my-repo --domain my-domain --domain-owner 111122223333 --upstreams repositoryName=npm-store

    Data berformat JSON muncul dalam output dengan detail tentang pembaruan repositori Anda, termasuk repositori hulu barunya.

    {
    "repository": {
        "name": "my-repo",
        "administratorAccount": "111122223333",
        "domainName": "my-domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/my-repo",
        "upstreams": [
            {
                "repositoryName": "npm-store"
            }
        ],
        "externalConnections": []
    }
}

    Untuk informasi selengkapnya, lihat Menambahkan atau menghapus repositori upstream ()AWS CLI.

  6. Penggunaan perintah login untuk mengonfigurasi manajer paket npm Anda dengan repositori my-repo. 

    aws codeartifact login --tool npm --repository my-repo --domain my-domain --domain-owner 111122223333

    Anda akan menerima output yang mengonfirmasi Anda berhasil masuk.

    Successfully configured npm to use AWS CodeArtifact repository https://my-domain-111122223333.d.codeartifact.us-east-2.amazonaws.com/npm/my-repo/
Login expires in 12 hours at 2020-10-08 02:45:33-04:00

    Untuk informasi selengkapnya, lihat Konfigurasikan dan gunakan npm dengan CodeArtifact.

  7. Gunakan CLI npm untuk menginstal paket npm. Misalnya, untuk menginstal paket npm populer lodash, gunakan perintah berikut. 

    npm install lodash

  8. Gunakan perintah list-packages untuk melihat paket yang baru saja Anda instal di repositori my-repo.

    catatan

    Mungkin ada penundaan antara ketika perintah npm install install selesai dan ketika paket terlihat di repositori Anda. Untuk detail tentang latensi tipikal saat mengambil paket dari repositori publik, lihat. Latensi koneksi eksternal 

    aws codeartifact list-packages --domain my-domain --repository my-repo

    Data berformat JSON muncul dalam output dengan format dan nama paket yang Anda instal. 

    {
    "packages": [
        {
            "format": "npm",
            "package": "lodash"
        }
    ]
}

    Anda sekarang memiliki tiga CodeArtifact sumber daya:

    • Domain my-domain.

    • Repositori my-repo yang berada di my-domain. Repositori ini memiliki paket npm yang tersedia untuk itu.

    • Repositori npm-store yang berada di my-domain. Repositori ini memiliki koneksi eksternal ke repositori npm publik dan dikaitkan sebagai repositori hulu dengan repositori my-repo.

  9. Untuk menghindari AWS biaya lebih lanjut, hapus sumber daya yang Anda gunakan selama tutorial ini:

    catatan

    Anda tidak dapat menghapus domain yang berisi repositori, sehingga Anda harus menghapus my-repo dan npm-store sebelum Anda menghapus my-domain.

    1. Gunakan perintah delete-repository untuk menghapus repositori npm-store. 

      aws codeartifact delete-repository --domain my-domain --domain-owner 111122223333 --repository my-repo

      Data berformat JSON muncul dalam output dengan detail mengenai repositori yang dihapus. 

      {
    "repository": {
        "name": "my-repo",
        "administratorAccount": "111122223333",
        "domainName": "my-domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/my-repo",
        "upstreams": [
            {
                "repositoryName": "npm-store"
            }
        ],
        "externalConnections": []
    }
}

    2. Gunakan perintah delete-repository untuk menghapus repositori npm-store. 

      aws codeartifact delete-repository --domain my-domain --domain-owner 111122223333 --repository npm-store

      Data berformat JSON muncul dalam output dengan detail mengenai repositori yang dihapus.

      {
    "repository": {
        "name": "npm-store",
        "administratorAccount": "111122223333",
        "domainName": "my-domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/npm-store",
        "upstreams": [],
        "externalConnections": [
            {
                "externalConnectionName": "public:npmjs",
                "packageFormat": "npm",
                "status": "AVAILABLE"
            }
        ]
    }
}

    3. Gunakan perintah delete-domain untuk menghapus repositori my-domain. 

      aws codeartifact delete-domain --domain my-domain --domain-owner 111122223333

      Data berformat JSON muncul dalam output dengan detail tentang domain yang dihapus.

      {
    "domain": {
        "name": "my-domain",
        "owner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:domain/my-domain",
        "status": "Deleted",
        "createdTime": "2020-10-07T15:36:35.194000-04:00",
        "encryptionKey": "arn:aws:kms:us-west-2:111122223333:key/your-kms-key",
        "repositoryCount": 0,
        "assetSizeBytes": 0
    }
}