Mengelola repositori contoh kustom di Cloud Code for IntelliJ
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Repositori contoh adalah repositori Git yang berisi contoh kustom yang Anda buat dan dapat digunakan tim Anda untuk mengembangkan aplikasi.
Artinya, dalam organisasi atau tim, Anda dapat menyiapkan repositori contoh dengan Cloud Code, yang disesuaikan dengan organisasi Anda, untuk menawarkan serangkaian standar aplikasi, layanan, dan konfigurasi infrastruktur awal yang dapat digunakan orang lain. Hal ini membantu menyelaraskan project baru dengan standar dan tumpukan teknologi pilihan organisasi Anda, serta mendorong praktik terbaik di awal siklus pengembangan.
Repositori contoh dapat berupa repositori aplikasi contoh yang sudah ada yang telah Anda buat atau kumpulan contoh baru yang ingin Anda gunakan oleh orang lain.
Untuk mengimpor repositori dengan Cloud Code, Anda menambahkan
file deskripsi contoh ke repositori.
Jika sudah siap, repositori contoh dapat dibagikan dengan mudah kepada tim Anda; mereka harus menyiapkan Cloud Code dan menggunakan URL Git repositori contoh. Untuk repositori Git pribadi, hanya anggota yang memiliki akses ke
repositori yang dapat menggunakan sampel kustom pokok.
Untuk melihat contoh cara menyiapkan repositori contoh, lihat
repositori ini.
Sebelum memulai
Pastikan Git versi 2.25.0 atau yang lebih baru telah diinstal di komputer lokal Anda.
Membuat repositori contoh
Untuk menggunakan repositori yang ada, lanjutkan ke
membuat file deskriptor contoh. Untuk membuat repositori baru yang akan digunakan sebagai repositori contoh, ikuti langkah-langkah berikut:
Buat repositori Git baru.
Repositori Git Anda dapat dihosting dari jarak jauh atau langsung di komputer lokal Anda. Contoh ini menggunakan repositori GitHub baru, 'custom-sample-repo'.
Tambahkan direktori contoh ke repositori.
Direktori sampel Anda dapat berisi apa saja dan berada di mana saja yang Anda inginkan di repositori. Dalam contoh ini, dua direktori sampel, 'hello-world' dan 'kubernetes-custom-sample', telah ditambahkan ke 'custom-sample-repo'.
Sebaiknya sertakan file readme dengan petunjuk tentang cara terbaik menggunakan sampel kustom Anda.
Di tabel Repositori Contoh Kustom, pilih URL repositori yang ingin Anda hapus, lalu klik - Hapus.
Pada dialog konfirmasi yang muncul, klik Hapus untuk menghapus repositori yang dipilih dari Cloud Code.
Mendapatkan dukungan
Untuk mengirimkan masukan atau melaporkan masalah di IDE IntelliJ, buka
Tools > Cloud Code > Help / About > Submit
feedback or report an issue untuk melaporkan masalah di GitHub.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-09-05 UTC."],[[["\u003cp\u003eA sample repository in Cloud Code contains custom samples for teams to use in developing applications, promoting standardized starter configurations.\u003c/p\u003e\n"],["\u003cp\u003eSample repositories can be existing or newly created Git repositories, requiring a \u003ccode\u003e.cctemplate\u003c/code\u003e descriptor file in the root directory for Cloud Code to recognize them.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003e.cctemplate\u003c/code\u003e file defines metadata and an array of samples, each with details like path, name, and an optional description, enabling Cloud Code to understand and use each custom template.\u003c/p\u003e\n"],["\u003cp\u003eTo share sample repositories, users need Cloud Code and the repository's Git URL, and access to private repositories is limited to authorized members only.\u003c/p\u003e\n"],["\u003cp\u003eCustom sample repositories can be removed from Cloud Code either by manually deleting them or by navigating through the \u003cstrong\u003ePreferences\u003c/strong\u003e to remove the desired repository.\u003c/p\u003e\n"]]],[],null,["# Manage custom sample repositories in Cloud Code for IntelliJ\n\nA sample repository is a Git repository that contains custom samples you\ncreate that your team can use to develop applications.\n\nThis means that, within an organization or team, you can set up sample\nrepositories with Cloud Code, custom to your organization, to offer a\nstandard set of starter applications, services, and infrastructure configuration\nthat others can use. This helps align new projects with your organization's\npreferred technical stack and standards, and encourages best practices at the\nbeginning of the development cycle.\n\nA sample repository can be an existing repository of sample applications\nyou've already created or a new set of samples you'd like others to use.\nTo import a repository with Cloud Code, you add a\n[sample descriptor file](#sample_descriptor_schema) to the repository.\n\nWhen ready, sample repositories are easy to share with your team; they'll\nneed Cloud Code set up and the Git URL of the sample repository\nto use. For private Git repositories, only members that have access to the\nrepository can use the underlying custom samples.\n\nTo see an example of how a sample repository might be set up, reference this\n[repository](https://github.com/GoogleCloudPlatform/cloud-code-custom-samples-example/).\n\nBefore you begin\n----------------\n\nMake sure that Git version 2.25.0 or later is installed on your local\nmachine.\n\n\nCreating a sample repository\n----------------------------\n\nTo use an existing repository, skip to\n[creating a sample descriptor file](#sample_descriptor). To create a new\nrepository to use as a sample repository, follow these steps:\n\n1. Create a new Git repository.\n\n Your Git repository can be hosted remotely or live on your local\n machine. This example uses a new GitHub repository, 'custom-sample-repo'.\n\n2. Add sample directories to the repository.\n\n Your sample directories can contain anything and be located anywhere you\n want in the repository. In this example, two sample directories,\n 'hello-world' and 'kubernetes-custom-sample', have been added\n to 'custom-sample-repo'.\n\n A readme file with instructions on how best to use your custom samples\n is highly recommended.\n\n\n3. Create a sample descriptor file.\n\n A sample descriptor file provides Cloud Code with information\n on your sample to properly create your application. This file must be named\n `.cctemplate`, must be located in your root directory, and must have the\n schema defined in the\n [sample descriptor file schema](#sample_descriptor_schema) section.\n4. Test your custom sample by following the steps to\n [create an app from a custom sample](/code/docs/intellij/create-app-from-custom-sample).\n\nSample descriptor schema\n------------------------\n\n#### Example\n\n {\n \"metadata\":{\n \"version\":\"1\"\n },\n \"name\": \"My Sample Repository\",\n \"templates\":[\n {\n \"path\":\"/path/to/sample1_location\",\n \"name\":\"My Sample 1\",\n \"description\":\"The first sample of its name.\"\n },\n {\n \"path\":\"/path/to/sample2_location\",\n \"name\":\"My Sample 2\",\n \"description\":\"The sequel.\"\n }\n ]\n }\n\n### Sample schema\n\n#### Example\n\n {\n \"path\":\"path/to/sample1\",\n \"name\":\"My Sample 1\",\n \"description\":\"The first sample of its name.\"\n }\n\n### Metadata schema\n\n#### Example\n\n {\n \"version\":\"1\"\n }\n\nDeleting a custom sample repository\n-----------------------------------\n\nTo delete a custom sample, which removes it from the custom application\nselector flow and from users' machines:\n\n1. In the `settings.json` file, look up the `localPath` for the custom sample\n entry.\n\n \"cloudcode.customApplications\": [\n {\n \"repoUrl\": https://github.com/GoogleCloudPlatform/cloud-code-custom-samples-example.git,\n \"branchName\": \"\",\n \"localPath\": \"/Users/username/Library/cloud-code/custom-templates/https-github-com-google-cloud-platform-cloud-code-custom-samples-example-git\"\n }\n ],\n\n2. Delete the template folder at the path.\n\n | **Note:** On Macs, `Library` is a hidden folder.\n3. Delete the custom sample section from the `settings.json` file.\n\nDeleting a custom sample repository\n-----------------------------------\n\nTo delete a custom sample repository from Cloud Code:\n\n1. Navigate to **Preferences** \\\u003e **Tools** \\\u003e **Cloud Code** \\\u003e\n **Custom Samples**.\n\n2. In the **Custom Sample Repositories** table, select the repository URL that\n you want to remove and click **- Remove**.\n\n3. In the confirmation dialog that appears, click **Remove** to delete the\n selected repository from Cloud Code.\n\nGet support\n-----------\n\nTo submit feedback or report an issue in your IntelliJ IDE, go to **Tools** \\\u003e **Cloud Code** \\\u003e **Help / About** \\\u003e **Submit\nfeedback or report an issue** to report an issue on [GitHub](https://github.com/GoogleCloudPlatform/cloud-code-intellij/issues)."]]
