Memindai paket Go secara otomatis

Memindai paket Go 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 mendemonstrasikan 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

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.

Install the Google Cloud CLI.

Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut:

gcloud init

Create or select a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

• Create a Google Cloud project:

  gcloud projects create PROJECT_ID

  Replace PROJECT_ID with a name for the Google Cloud project you are creating.

• Select the Google Cloud project that you created:

  gcloud config set project PROJECT_ID

  Replace PROJECT_ID with your Google Cloud project name.

Verify that billing is enabled for your Google Cloud project.

Enable the Artifact Registry and Container Scanning APIs:

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

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

Install the Google Cloud CLI.

Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut:

gcloud init

Create or select a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

• Create a Google Cloud project:

  gcloud projects create PROJECT_ID

  Replace PROJECT_ID with a name for the Google Cloud project you are creating.

• Select the Google Cloud project that you created:

  gcloud config set project PROJECT_ID

  Replace PROJECT_ID with your Google Cloud project name.

Verify that billing is enabled for your Google Cloud project.

Enable the Artifact Registry and Container Scanning APIs:

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

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

Penting: Saat Anda mengaktifkan Container Scanning API, penagihan akan segera dimulai. Setelah Anda mengaktifkan API untuk project, Artifact Analysis akan otomatis memindai setiap image yang baru di-push ke Artifact Registry dalam project tersebut.

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 Buat.

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

Mengonfigurasi autentikasi

Sebelum Anda 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 menarik image Go terbaru dari Docker Hub.

   docker pull golang:1.17.6-alpine
   

Beri tag pada paket Anda dengan nama repositori

Saat 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 golang:1.17.6-alpine \
us-central1-docker.pkg.dev/PROJECT/quickstart-docker-repo/quickstart-image:tag1

Dengan:

• PROJECT adalah Google Cloud project ID Anda. Jika project ID Anda berisi titik dua (:), lihat Project yang tercakup dalam 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 image dapat berbeda dengan nama image 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 paket Go baru saat diupload ke Artifact Registry.

Untuk mengirim image Anda 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 Google Cloud project ID Anda. Jika project ID Anda berisi titik dua (:), lihat Project yang tercakup dalam domain.

Melihat hasil pemindaian kerentanan

Untuk melihat kerentanan dalam image:

1. Dapatkan daftar repositori.

   Buka halaman Repositori

2. Di daftar repositori, klik repositori.

3. Di daftar gambar, klik nama gambar.

   Jumlah total kerentanan untuk setiap ringkasan gambar ditampilkan di kolom Kerentanan.

   

4. Untuk melihat daftar kerentanan pada image, klik link di kolom Kerentanan.

   Bagian Hasil pemindaian menampilkan ringkasan jenis paket yang dipindai, total kerentanan, kerentanan dengan perbaikan yang tersedia, kerentanan tanpa perbaikan, dan tingkat keparahan efektif.

   

   Tabel kerentanan mencantumkan nama Kerentanan dan Eksposur Umum (CVE) untuk setiap kerentanan yang ditemukan, tingkat keparahan efektif, skor Sistem Penskoran Kerentanan Umum (CVSS), perbaikan (jika tersedia), nama paket yang berisi kerentanan, dan jenis paket.

   KonsolGoogle Cloud menampilkan hingga 1.200 kerentanan per halaman dalam tabel ini. Anda dapat memfilter dan mengurutkan file ini untuk memeriksa file, direktori, lapisan, atau jenis file tertentu menurut ekstensi file.

5. Untuk mengetahui detail CVE tertentu, klik nama CVE.

6. Untuk melihat detail kemunculan kerentanan seperti nomor versi dan lokasi yang terpengaruh, di baris dengan nama kerentanan, klik Lihat atau Lihat yang Diperbaiki. Teks link adalah Lihat untuk kerentanan tanpa perbaikan, dan Lihat yang Diperbaiki untuk kerentanan yang telah diperbaiki.

Melihat kerentanan di lapisan tertentu

Preview

This product or feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

Analisis Artefak menyediakan metadata khusus lapisan untuk membantu Anda mengidentifikasi paket mana yang berisi kerentanan, dan perintah build Docker mana yang memperkenalkan lapisan tersebut.

Untuk melihat metadata kerentanan berbasis lapisan di konsol Google Cloud :

1. Di Artifact Registry, buka daftar repositori Anda.

   Buka halaman Repositori

2. Di halaman Repositori, klik repositori.

3. Di halaman Repository Details, klik gambar.

4. Dalam daftar versi gambar, klik ringkasan gambar.

5. Di halaman detail ringkasan gambar, klik tab Kerentanan.

   Jika metadata berbasis lapisan tersedia, Analisis Artefak akan menampilkan daftar lapisan yang dapat dipilih di kolom Lapisan:

   

6. Untuk melihat daftar lapisan, klik menu drop-down lapisan.

   Daftar drop-down akan terbuka, menampilkan daftar lapisan bernomor. Lapisan 0 mewakili lapisan bawah, dengan setiap lapisan berikutnya dibangun di atas lapisan sebelumnya. Hanya lapisan yang ditemukan kerentanannya yang ditampilkan.

   

   Untuk setiap lapisan, Analisis Artefak menampilkan perintah Docker yang digunakan untuk membangun lapisan dan jumlah kerentanan yang ditemukan di lapisan tersebut.

7. Untuk mempelajari lebih lanjut kerentanan di lapisan tertentu, pilih lapisan dari daftar lapisan.

   Tabel kerentanan diperbarui untuk menampilkan hanya kerentanan yang ditemukan di lapisan yang dipilih. Anda dapat menerapkan lebih banyak filter atau menyelidiki kerentanan tertentu.

8. Klik LIHAT atau LIHAT PERBAIKAN di samping kerentanan untuk melihat informasi kerentanan yang lebih mendetail.

   Panel samping Detail kerentanan menampilkan lokasi file tempat paket memiliki kerentanan.

9. Pada tabel Lokasi file, arahkan kursor ke tanda tanya untuk membuka metadata lapisan tambahan.

   Dialog menampilkan indeks lapisan, perintah build lapisan, ringkasan lapisan, dan image dasar tempat Anda dapat memperbaiki kerentanan.

Pembersihan

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

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

Perhatian: Menghapus project memiliki efek berikut:

• Semua hal dalam project akan dihapus. Jika menggunakan project yang sudah ada untuk tugas dalam dokumen ini, saat Anda menghapusnya, pekerjaan lain yang telah Anda lakukan dalam project tersebut juga akan terhapus.
• Project ID kustom hilang. Saat membuat project ini, Anda mungkin telah membuat project ID kustom yang ingin digunakan di masa mendatang. Untuk mempertahankan URL yang menggunakan project ID, seperti URL appspot.com, hapus resource yang dipilih di dalam project, bukan menghapus seluruh project.

Jika Anda berencana mempelajari beberapa arsitektur, tutorial atau panduan memulai, dengan menggunakan kembali project dapat membantu Anda agar tidak melampaui batas kuota project.

Delete a Google Cloud project:

gcloud projects delete PROJECT_ID

Langkah berikutnya

• Jelajahi opsi pemindaian on-demand.
• Pahami konsep pemindaian container.