Panduan memulai: Men-deploy layanan C++ ke Cloud Run

Panduan memulai: Men-deploy layanan C++ ke Cloud Run

Pelajari cara membuat aplikasi Hello World sederhana, mengemasnya ke dalam image container, mengupload image container ke Artifact Registry, lalu men-deploy image container ke Cloud Run.

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. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   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.

   Go to project selector

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

4. Install the Google Cloud CLI.

5. To initialize the gcloud CLI, run the following command:

   gcloud init

   Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.

6. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   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.

   Go to project selector

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

8. Install the Google Cloud CLI.

9. To initialize the gcloud CLI, run the following command:

   gcloud init

   Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
10. Guna menetapkan project default untuk layanan Cloud Run Anda:

     gcloud config set project PROJECT_ID

    Ganti PROJECT_ID dengan project ID Google Cloud Anda.

11. Jika Anda dikenai kebijakan organisasi pembatasan domain yang membatasi pemanggilan yang tidak diautentikasi untuk project, Anda perlu mengakses layanan yang di-deploy seperti yang dijelaskan di bagian Menguji layanan pribadi.

12. Aktifkan Cloud Run Admin API dan Cloud Build API:

    gcloud services enable run.googleapis.com \
        cloudbuild.googleapis.com

    Setelah Cloud Run Admin API diaktifkan, akun layanan default Compute Engine akan otomatis dibuat.

13. Agar Cloud Build dapat mem-build sumber Anda, berikan peran Cloud Build Service Account ke akun layanan default Compute Engine dengan menjalankan perintah berikut:
    gcloud projects add-iam-policy-binding PROJECT_ID \
        --member=serviceAccount:[e-mail] \
        --role=roles/cloudbuild.builds.builder

    Ganti PROJECT_NUMBER dengan nomor project Google Cloud Anda, dan PROJECT_ID dengan project ID Google Cloud Anda. Untuk petunjuk mendetail tentang cara menemukan project ID dan nomor project, lihat Membuat dan mengelola project.

    Pemberian peran Akun Layanan Cloud Build ke akun layanan default Compute Engine memerlukan waktu beberapa menit untuk disebarkan.

    Catatan:

    Batasan kebijakan organisasi iam.automaticIamGrantsForDefaultServiceAccounts mencegah peran Editor diberikan secara otomatis ke akun layanan default. Jika Anda membuat organisasi setelah 3 Mei 2024, batasan ini akan diterapkan secara default.

    Sebaiknya terapkan batasan ini untuk menonaktifkan pemberian peran otomatis. Jika Anda menonaktifkan pemberian peran otomatis, Anda harus menentukan peran mana yang akan diberikan ke akun layanan default, lalu memberikan peran ini secara manual.

    Jika akun layanan default sudah memiliki peran Editor, sebaiknya ganti peran Editor dengan peran yang kurang permisif.Untuk mengubah peran akun layanan dengan aman, gunakan Policy Simulator untuk melihat dampak perubahan, lalu berikan dan cabut peran yang sesuai.

Menulis aplikasi contoh

Menulis aplikasi dalam C++

1. Buatlah direktori bernama baru helloworld-cpp dan ubahlah direktori tersebut kedalamnya:

   mkdir helloworld-cpp
   cd helloworld-cpp
   

2. Buatlah file bernama baru CMakeLists.txt lalu tempelkan kode yang mengikuti ke dalamnya:

   cmake_minimum_required(VERSION 3.20)
   
   # Define the project name and where to report bugs.
   set(PACKAGE_BUGREPORT
       "https://github.com/GoogleCloudPlatform/cpp-samples/issues")
   project(cpp-samples-cloud-run-hello-world CXX)
   
   find_package(functions_framework_cpp REQUIRED)
   find_package(Threads)
   
   add_executable(cloud_run_hello cloud_run_hello.cc)
   target_compile_features(cloud_run_hello PRIVATE cxx_std_17)
   target_link_libraries(cloud_run_hello functions-framework-cpp::framework)
   
   include(GNUInstallDirs)
   install(TARGETS cloud_run_hello RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR})

3. Buatlah file bernama baru vcpkg.json lalu tempelkan kode yang mengikuti ke dalamnya:

   {
     "name": "cpp-samples-cloud-run-hello-world",
     "version-string": "unversioned",
     "homepage": "https://github.com/GoogleCloudPlatform/cpp-samples/",
     "description": [
       "Shows how to deploy a C++ application to Cloud Run."
     ],
     "dependencies": [
       "functions-framework-cpp"
     ]
   }
   

4. Buatlah file bernama baru cloud_run_hello.cc lalu tempelkan kode yang mengikuti ke dalamnya:

   #include <google/cloud/functions/framework.h>
   #include <cstdlib>
   
   namespace gcf = ::google::cloud::functions;
   
   auto hello_world_http() {
     return gcf::MakeFunction([](gcf::HttpRequest const& /*request*/) {
       std::string greeting = "Hello ";
       auto const* target = std::getenv("TARGET");
       greeting += target == nullptr ? "World" : target;
       greeting += "\n";
   
       return gcf::HttpResponse{}
           .set_header("Content-Type", "text/plain")
           .set_payload(greeting);
     });
   }
   
   int main(int argc, char* argv[]) {
     return gcf::Run(argc, argv, hello_world_http());
   }
   

   Kode ini menghasilkan sebuah web server dasar yang memantau port yang ditentukan oleh variabel PORT lingkungan.

5. Buatlah file bernama baru Dockerfile dalam direktori yang sama seperti file sumber. Dockerfile C++ memulai aplikasi yang memantau port yang ditentukan oleh variabel lingkungan PORT:

   # We chose Alpine to build the image because it has good support for creating
   # statically-linked, small programs.
   FROM alpine:3.21 AS build
   
   # Install the typical development tools for C++, and
   # the base OS headers and libraries.
   RUN apk update && \
       apk add \
           build-base \
           cmake \
           curl \
           git \
           gcc \
           g++ \
           libc-dev \
           linux-headers \
           ninja \
           pkgconfig \
           tar \
           unzip \
           zip
   
   # Use `vcpkg`, a package manager for C++, to install
   WORKDIR /usr/local/vcpkg
   ENV VCPKG_FORCE_SYSTEM_BINARIES=1
   RUN curl -sSL "https://github.com/Microsoft/vcpkg/archive/2024.04.26.tar.gz" | \
       tar --strip-components=1 -zxf - \
       && ./bootstrap-vcpkg.sh -disableMetrics
   
   # Copy the source code to /v/source and compile it.
   COPY . /v/source
   WORKDIR /v/source
   
   # Run the CMake configuration step, setting the options to create
   # a statically linked C++ program
   RUN cmake -S/v/source -B/v/binary -GNinja \
       -DCMAKE_TOOLCHAIN_FILE=/usr/local/vcpkg/scripts/buildsystems/vcpkg.cmake \
       -DCMAKE_BUILD_TYPE=Release
   
   # Compile the binary and strip it to reduce its size.
   RUN cmake --build /v/binary
   RUN strip /v/binary/cloud_run_hello
   
   # Create the final deployment image, using `scratch` (the empty Docker image)
   # as the starting point. Effectively we create an image that only contains
   # our program.
   FROM scratch AS cloud-run-hello
   WORKDIR /r
   
   # Copy the program from the previously created stage and the shared libraries it
   # depends on.
   COPY --from=build /v/binary/cloud_run_hello /r
   COPY --from=build /lib/ld-musl-x86_64.so.1 /lib/ld-musl-x86_64.so.1
   COPY --from=build /usr/lib/libstdc++.so.6 /usr/lib/libstdc++.so.6
   COPY --from=build /usr/lib/libgcc_s.so.1 /usr/lib/libgcc_s.so.1
   
   # Make the program the entry point.
   ENTRYPOINT [ "/r/cloud_run_hello" ]

Aplikasi Anda sudah selesai dan siap untuk di-deploy.

Deploy ke Cloud Run dari sumber

Penting: Panduan memulai ini mengasumsikan bahwa Anda memiliki peran pemilik atau editor dalam project yang Anda gunakan untuk panduan memulai tersebut. Atau, lihat peran Developer Sumber Cloud Run untuk mengetahui izin yang diperlukan guna men-deploy resource Cloud Run dari sumber.

Penggunaan Cloud Build untuk dibuatkan image dari kode sumber dan men-deploynya.

1. Di sumber direktori,penggunaan Cloud Build untuk membuat image docker untuk layanan Anda

   gcloud builds submit --machine-type=e2_highcpu_32 --tag gcr.io/PROJECT_ID/cloud-run-hello-world

2. Men-deploy image penggunaan menentukan perintah:

   gcloud run deploy --image=gcr.io/PROJECT_ID/cloud-run-hello-world

   Jika diminta mengaktifkan API, Balas y untuk mengaktifkan.

   1. Saat diminta memasukkan nama layanan, tekan Enter untuk menerima nama default, misalnya helloworld.

   2. Jika Anda diminta untuk mengaktifkan API tambahan pada project, misalnya, Artifact Registry API, tanggapi dengan menekan y.

   3. Saat Anda diminta untuk memasukkan region: pilih region pilihan Anda, misalnya us-central1.

   4. Jika Anda diminta untuk membuat repositori di region yang ditentukan, respons dengan menekan y.

   5. Jika Anda diminta untuk mengizinkan pemanggilan yang tidak diautentikasi: respons y. Anda mungkin tidak melihat perintah ini jika ada kebijakan organisasi pembatasan domain yang mencegahnya. Untuk mengetahui detail selengkapnya, lihat bagian Sebelum memulai.

   Lalu tunggu sebentar sampai proses deployment selesai. Jika berhasil, command line akan menampilkan URL layanannya.

3. Kunjungi layanan yang telah di-deploy dengan membuka URL layanan pada browser web.

Lokasi Cloud Run

Cloud Run bersifat regional, berarti infrastruktur yang menjalankan layanan Cloud Run Anda terletak di region tertentu dan dikelola oleh Google agar tersedia secara redundan di semua zona dalam region tersebut.

Memenuhi persyaratan latensi, ketersediaan, atau ketahanan adalah faktor utama untuk memilih region tempat layanan Cloud Run dijalankan. Pada umumnya, Anda dapat memilih region yang paling dekat dengan pengguna Anda, tetapi Anda harus mempertimbangkan lokasi dari produk Google Cloud lain yang digunakan oleh layanan Cloud Run Anda. Menggunakan produk Google Cloud secara bersamaan di beberapa lokasi dapat memengaruhi latensi serta biaya layanan Anda.

Cloud Run tersedia di region berikut:

Tergantung harga Tingkat 1

• asia-east1 (Taiwan)
• asia-northeast1 (Tokyo)
• asia-northeast2 (Osaka)
• asia-south1 (Mumbai, India)
• europe-north1 (Finlandia) CO₂ Rendah
• europe-southwest1 (Madrid) CO₂ Rendah
• europe-west1 (Belgia) CO₂ Rendah
• europe-west4 (Belanda) CO₂ Rendah
• europe-west8 (Milan)
• europe-west9 (Paris) CO₂ Rendah
• me-west1 (Tel Aviv)
• us-central1 (Iowa) CO₂ Rendah
• us-east1 (South Carolina)
• us-east4 (North Virginia)
• us-east5 (Columbus)
• us-south1 (Dallas) CO₂ Rendah
• us-west1 (Oregon) CO₂ Rendah

Tergantung harga Tingkat 2

• africa-south1 (Johannesburg)
• asia-east2 (Hong Kong)
• asia-northeast3 (Seoul, Korea Selatan)
• asia-southeast1 (Singapura)
• asia-southeast2 (Jakarta)
• asia-south2 (Delhi, India)
• australia-southeast1 (Sydney)
• australia-southeast2 (Melbourne)
• europe-central2 (Warsawa, Polandia)
• europe-west10 (Berlin) CO₂ Rendah
• europe-west12 (Turin)
• europe-west2 (London, Inggris Raya) CO₂ Rendah
• europe-west3 (Frankfurt, Jerman) CO₂ Rendah
• europe-west6 (Zurich, Swiss) CO₂ Rendah
• me-central1 (Doha)
• me-central2 (Dammam)
• northamerica-northeast1 (Montreal) CO₂ Rendah
• northamerica-northeast2 (Toronto) CO₂ Rendah
• southamerica-east1 (São Paulo, Brasil) CO₂ Rendah
• southamerica-west1 (Santiago, Cile) CO₂ Rendah
• us-west2 (Los Angeles)
• us-west3 (Salt Lake City)
• us-west4 (Las Vegas)

Jika sudah membuat layanan Cloud Run, Anda dapat melihat region di dasbor Cloud Run di Konsol Google Cloud.

Oke

Selamat! Anda baru saja men-deploy image container dari kode sumber ke Cloud Run. Cloud Run meningkatkan skala image container secara otomatis dan horizontal untuk menangani permintaan yang diterima, lalu menurunkan skala saat permintaan berkurang. Anda hanya membayar untuk CPU, memori, dan jaringan yang terpakai selama penanganan permintaan.

Pembersihan

Menghapus project pengujian Anda

Meskipun Cloud Run tidak mengenakan biaya saat layanannya tidak digunakan, Anda mungkin tetap dikenai biaya atas penyimpanan image container di Artifact Registry. Anda dapat menghapus image container atau menghapus project Google Cloud untuk menghindari tagihan. Menghapus project Google Cloud Anda akan menghentikan penagihan untuk semua resource yang digunakan dalam project tersebut.

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.
1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

Langkah berikutnya

Untuk informasi lebih lanjut dalam mem-build container dari kode sumber dan penerapan untuk repositori, lihat:

• Mengembangkan layanan Cloud Run
• Mem-build Container
• Menguji layanan Cloud Run secara lokal
• Men-deploy dari kode sumber