Memindai paket OS secara otomatis

Pelajari cara mengaktifkan pemindaian otomatis, mengirim image container di Artifact Registry, dan melihat daftar kerentanan yang ditemukan dalam image.

Artifact Analysis memindai kerentanan setiap kali image dikirim ke Artifact Registry. Administrator platform dan developer aplikasi dapat menggunakan fitur pemindaian otomatis ini untuk membantu mengidentifikasi risiko dalam pipeline pengiriman software mereka.

Panduan memulai ini menggunakan paket sederhana yang tersedia secara publik untuk menunjukkan satu jenis pemindaian paket. Secara default, Artifact Analysis memindai kerentanan dalam beberapa jenis paket setelah Anda mengaktifkan API pemindaian. Jenis paket yang didukung meliputi: OS, Go, Java (Maven), Python, dan Node.js (npm).

Sebelum memulai

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
  2. Install the Google Cloud CLI.
  3. To initialize the gcloud CLI, run the following command:

    gcloud init
  4. Buat atau pilih project Google Cloud.

    • Membuat project Google Cloud:

      gcloud projects create PROJECT_ID

      Ganti PROJECT_ID dengan nama untuk project Google Cloud yang Anda buat.

    • Pilih project Google Cloud yang Anda buat:

      gcloud config set project PROJECT_ID

      Ganti PROJECT_ID dengan nama project Google Cloud Anda.

  5. Make sure that billing is enabled for your Google Cloud project.

  6. Aktifkan API Artifact Registry and Container Scanning:

    gcloud services enable containerscanning.googleapis.com  artifactregistry.googleapis.com
  7. Install the Google Cloud CLI.
  8. To initialize the gcloud CLI, run the following command:

    gcloud init
  9. Buat atau pilih project Google Cloud.

    • Membuat project Google Cloud:

      gcloud projects create PROJECT_ID

      Ganti PROJECT_ID dengan nama untuk project Google Cloud yang Anda buat.

    • Pilih project Google Cloud yang Anda buat:

      gcloud config set project PROJECT_ID

      Ganti PROJECT_ID dengan nama project Google Cloud Anda.

  10. Make sure that billing is enabled for your Google Cloud project.

  11. Aktifkan API Artifact Registry and Container Scanning:

    gcloud services enable containerscanning.googleapis.com  artifactregistry.googleapis.com

Membuat repositori Docker di Artifact Registry

Buat repositori Docker untuk menyimpan image sampel untuk panduan memulai ini.

  1. Buka halaman Repositories di konsol Google Cloud.

    Buka halaman Repositori

  2. Klik Create Repository.

  3. Di halaman Create Repository, masukkan setelan berikut:

    • Nama: quickstart-docker-repo
    • Format: Docker
    • Mode: Standar
    • Location type: Region
    • Region: us-central1
  4. Klik Create.

Anda akan melihat halaman Repositori. Repositori quickstart-docker-repo Anda ditambahkan ke daftar repositori.

Mengonfigurasi autentikasi

Sebelum dapat mengirim atau mengambil image dengan Artifact Registry, Anda harus mengonfigurasi Docker agar menggunakan Google Cloud CLI untuk mengautentikasi permintaan ke Artifact Registry.

Di Cloud Shell atau shell lokal Anda, siapkan autentikasi untuk repositori Docker di region us-central1:

gcloud auth configure-docker us-central1-docker.pkg.dev

Mendapatkan paket

  1. Ubah ke direktori tempat Anda ingin menyimpan image container.

  2. Salin gambar ke direktori lokal Anda. Misalnya, Anda dapat menggunakan docker untuk mengambil image Ubuntu terbaru dari Docker Hub.

    docker pull ubuntu:latest
    

Memberi tag pada paket dengan nama repositori

Jika ingin mengirim paket ke Artifact Registry, Anda perlu mengonfigurasi perintah docker push untuk mengirim image ke lokasi tertentu.

Jalankan perintah berikut untuk memberi tag pada image sebagai quickstart-image:tag1:

docker tag ubuntu:latest \
us-central1-docker.pkg.dev/PROJECT/quickstart-docker-repo/quickstart-image:tag1

Dari mana

  • PROJECT adalah project ID Google Cloud Anda. Jika project ID Anda berisi titik dua (:), lihat Project cakupan domain.
  • us-central1 adalah region repositori Artifact Registry.
  • docker.pkg.dev adalah nama host untuk repositori Docker.
  • quickstart-image adalah nama image yang ingin Anda gunakan di repositori. Nama gambar dapat berbeda dengan nama gambar lokal.
  • tag1 adalah tag yang Anda tambahkan ke image Docker. Jika Anda tidak menentukan tag, Docker akan menerapkan tag default latest.

Mengirim image ke Artifact Registry

Artifact Analysis secara otomatis memindai image baru saat diupload ke Artifact Registry.

Untuk mengirim image ke repositori Docker di Artifact Registry, jalankan perintah berikut:

docker push us-central1-docker.pkg.dev/PROJECT/quickstart-docker-repo/quickstart-image:tag1

Ganti PROJECT dengan project ID Google Cloud Anda. Jika project ID Anda berisi titik dua (:), lihat Project cakupan domain.

Melihat hasil pemindaian kerentanan

Untuk melihat kerentanan dalam image:

  1. Buka daftar repositori Artifact Registry Anda di konsol Artifact Analysis.

    Buka halaman Repositori

  2. Di daftar repositori, klik repositori.

  3. Klik nama gambar.

    Anda akan melihat daftar ringkasan untuk gambar Anda.

    Total kerentanan untuk setiap ringkasan gambar ditampilkan di kolom Vulnerabilities.

    Screenshot gambar dengan kerentanan

  4. Klik jumlah total kerentanan tertaut di kolom Vulnerabilities.

    Anda akan melihat daftar kerentanan.

    Screenshot daftar gambar dan detail kerentanan

    Daftar kerentanan menunjukkan frekuensi gambar ini telah dipindai, tingkat keparahan kerentanan, ketersediaan perbaikan, nama paket yang berisi kerentanan, dan jenis paket.

  5. Untuk mempelajari lebih lanjut kerentanan tertentu dari sumber kerentanan, klik ID CVE tertaut di kolom Nama.

Cara lain untuk melihat hasil

Konsol Google Cloud menampilkan hingga 1.200 kerentanan. Jika image Anda memiliki lebih dari 1.200 kerentanan, gunakan gcloud atau API untuk melihat daftar lengkapnya.

Pembersihan

Agar tidak menimbulkan biaya pada akun Google Cloud Anda untuk resource yang digunakan pada halaman ini, hapus project Google Cloud yang berisi resource tersebut.

Jika Anda membuat project baru untuk panduan ini, sekarang Anda dapat menghapus project tersebut.

  1. Di konsol Google Cloud, buka halaman Manage resource.

    Buka Manage resource

  2. Pada daftar project, pilih project yang ingin Anda hapus, lalu klik Delete.
  3. Pada dialog, ketik project ID, lalu klik Shut down untuk menghapus project.

Langkah selanjutnya