กำหนดค่าการปรับแต่งโค้ดของ Gemini Code Assist

ในคอนโซล Google Cloud ให้ไปที่หน้าการปรับแต่งโค้ด

ไปที่การปรับแต่งโค้ดสำหรับ Gemini Code Assist

หน้าการปรับแต่งโค้ดสำหรับ Gemini Code Assist จะโหลดขึ้น

สร้างดัชนี การปรับแต่งโค้ดอาศัยดัชนีในการวิเคราะห์และแยกวิเคราะห์ ที่เก็บของคุณเพื่อให้คำแนะนำในการสร้างโค้ดและการค้นหาที่รวดเร็วขึ้น

1. คลิกสร้างและกำหนดค่ารายละเอียดดัชนี

   • เลือกภูมิภาคที่กำหนดค่าไว้ใน Developer Connect ในโปรเจ็กต์ Cloud
   • ป้อนชื่อดัชนี จดชื่อดัชนี คุณต้องใช้ ในหลายขั้นตอนในเอกสารนี้

2. คลิกสร้าง

โดยทั่วไปการสร้างดัชนีจะใช้เวลา 30 นาที แต่บางครั้งอาจใช้เวลาถึง 1 ชั่วโมง เมื่อจัดทำดัชนีเสร็จสมบูรณ์ คุณจะได้รับการแจ้งเตือนใน คอนโซล Google Cloud

Google จำกัดจำนวนดัชนีที่เก็บโค้ดไว้ที่ 1 รายการสำหรับแต่ละโปรเจ็กต์และองค์กร

ควบคุมการเข้าถึงดัชนีโดยใช้กลุ่มที่เก็บ

กลุ่มที่เก็บคือคอนเทนเนอร์สำหรับการกำหนดค่าการจัดทำดัชนี ซึ่งรวมถึงที่เก็บและรูปแบบสาขาของที่เก็บ กลุ่มที่เก็บได้รับการออกแบบมาเพื่อการควบคุม IAM แบบละเอียด ซึ่งช่วยให้นักพัฒนาซอฟต์แวร์เข้าถึงข้อมูลที่จัดทำดัชนีจากกลุ่มเหล่านั้นได้เมื่อมีcloudaicompanion.repositoryGroups.useสิทธิ์

กลุ่มที่เก็บมีที่เก็บ Developer Connect หรือลิงก์จากโปรเจ็กต์และตำแหน่งเดียวกัน

ในหน้าการปรับแต่งโค้ดสำหรับ Gemini Code Assist ให้คลิก เพิ่มที่เก็บ แล้วเลือกเพิ่มที่เก็บแหล่งที่มา

รายการจะแสดงที่เก็บที่มีอยู่ใน Developer Connect สำหรับ ภูมิภาคที่คุณกำหนดค่าในขั้นตอนก่อนหน้าเพื่อสร้างดัชนี

หากต้องการเพิ่มที่เก็บใหม่ลงในกลุ่มที่เก็บ ให้คลิกลิงก์ที่เก็บ แล้วทำตามขั้นตอนในคอนโซล Google Cloud

นอกจากนี้ คุณยังเลือกและแก้ไขที่เก็บอย่างน้อย 1 รายการเพื่อเพิ่ม สาขาใหม่ได้ด้วย

เลือกกลุ่มที่เก็บที่ต้องการเพิ่มที่เก็บใหม่ หรือคลิกสร้างกลุ่มที่เก็บใหม่เพื่อสร้างและ กำหนดค่ากลุ่มที่เก็บใหม่

หากต้องการเริ่มจัดทำดัชนีที่เก็บที่เลือก ให้คลิกจัดทำดัชนี

เวลาในการจัดทำดัชนีจะแตกต่างกันไปตามขนาดของที่เก็บ

• GitHub.com
• GitLab.com
• Bitbucket.org

ในสภาพแวดล้อมเชลล์ ให้เรียกใช้คำสั่ง gcloud components update เพื่อยืนยันว่าคุณได้อัปเดตคอมโพเนนต์ทั้งหมดของ gcloud ที่ติดตั้งไว้เป็นเวอร์ชันล่าสุดแล้ว สำหรับขั้นตอนนี้ คุณสามารถติดตั้งและเริ่มต้นใช้งาน gcloud หรือจะใช้ Cloud Shell Editor ก็ได้

gcloud components update

สร้างดัชนี การปรับแต่งโค้ดอาศัยดัชนีในการวิเคราะห์และแยกวิเคราะห์ ที่เก็บของคุณเพื่อให้คำแนะนำในการสร้างโค้ดและการค้นหาที่รวดเร็วขึ้น

1. หากต้องการสร้างดัชนี ให้ใช้gemini code-repository-indexes create คำสั่งในสภาพแวดล้อมเชลล์

   gcloud gemini code-repository-indexes create INDEX_NAME \
       --project=PROJECT_ID \
       --location=REGION
   

   แทนที่ค่าต่อไปนี้

   • INDEX_NAME: ชื่อดัชนี สำคัญ จดชื่อดัชนีไว้ ซึ่งจะต้องใช้ในหลายขั้นตอนในเอกสารนี้
   • PROJECT_ID: รหัสโปรเจ็กต์ Google Cloud
   • REGION: ภูมิภาคที่กำหนดค่าใน Developer Connect ในโปรเจ็กต์ Cloud คุณต้องระบุภูมิภาคที่รองรับเพื่อให้คำสั่งสำเร็จ

   โดยทั่วไปการสร้างดัชนีจะใช้เวลา 30 นาที แต่บางครั้งอาจใช้เวลาถึง 1 ชั่วโมง

   Google จำกัดจำนวนดัชนีที่เก็บโค้ดไว้ที่ 1 รายการสำหรับแต่ละโปรเจ็กต์และองค์กร

ควบคุมการเข้าถึงดัชนีโดยใช้กลุ่มที่เก็บ กลุ่มที่เก็บเป็นคอนเทนเนอร์สำหรับการกำหนดค่าการจัดทำดัชนี ซึ่งรวมถึงที่เก็บและรูปแบบสาขาของที่เก็บ กลุ่มที่เก็บได้รับการออกแบบมาเพื่อการควบคุม IAM แบบละเอียด ซึ่งช่วยให้นักพัฒนาซอฟต์แวร์เข้าถึงข้อมูลที่จัดทำดัชนี จากกลุ่มเหล่านั้นได้เมื่อมีcloudaicompanion.repositoryGroups.useสิทธิ์

กลุ่มที่เก็บมีที่เก็บ Developer Connect หรือลิงก์จากโปรเจ็กต์และตำแหน่งเดียวกัน

ผู้ดูแลระบบจะดำเนินการต่อไปนี้

• สร้างทรัพยากรดัชนีที่เก็บโค้ด
• กำหนดค่าการเชื่อมต่อ Developer Connect ใหม่ในโปรเจ็กต์และตำแหน่งเดียวกัน
• ลิงก์ที่เก็บ Git ในการเชื่อมต่อ
• รับชื่อทรัพยากรของลิงก์ เลือกรูปแบบสาขาที่จะจัดทำดัชนีสำหรับแต่ละลิงก์ และวางไว้ในกลุ่มที่เก็บอย่างน้อย 1 กลุ่ม

หากต้องการสร้างกลุ่มที่เก็บ ให้ใช้gemini code-repository-indexes repository-groups create คำสั่งในสภาพแวดล้อมเชลล์

gcloud gemini code-repository-indexes repository-groups create REPOSITORY_GROUP \
    --project=PROJECT_ID \
    --location=REGION \
    --code-repository-index=INDEX_NAME \
    --repositories='[{"resource": "REPOSITORY_RESOURCE_NAME", "branchPattern": "BRANCH_NAMES"}]'

แทนที่ค่าต่อไปนี้

• REPOSITORY_GROUP: ชื่อของที่เก็บ กลุ่ม เช่น default
• REPOSITORY_RESOURCE_NAME: ชื่อของ ที่เก็บภายในการเชื่อมต่อ Developer Connect หากต้องการค้นหาชื่อที่เก็บ ให้ไปที่หน้าที่เก็บ Git ใน Google Cloud Console แล้วมองหารหัสการเชื่อมต่อในแท็บที่เก็บ ในคอลัมน์การเชื่อมต่อในตาราง หากต้องการคัดลอกชื่อทรัพยากร ให้คลิกเมนู more_vert เพื่อดูตัวเลือกเพิ่มเติม แล้วเลือกคัดลอกเส้นทางทรัพยากร
• BRANCH_NAMES: ชื่อสาขาที่คุณต้องการ จัดทำดัชนี เช่น main|dev

นอกจากนี้ คุณยังสร้างกลุ่มที่เก็บด้วยที่เก็บที่กำหนดไว้ในไฟล์ JSON (หรือ YAML) ซึ่งจัดรูปแบบดังนี้ได้ด้วย

[
  {
      "resource": "REPOSITORY_RESOURCE_NAME", "branchPattern": "main|dev"
  },
  {
      "resource": "REPOSITORY_RESOURCE_NAME", "branchPattern": "dev"
  }
]

- resource: REPOSITORY_RESOURCE_NAME
  branchPattern: main|dev

- resource: REPOSITORY_RESOURCE_NAME
  branchPattern: dev

หากต้องการสร้างกลุ่มที่เก็บตามไฟล์ JSON หรือ YAML ในสภาพแวดล้อมเชลล์ ให้ใช้คำสั่ง gemini code-repository-indexes repository-groups create

gcloud gemini code-repository-indexes repository-groups create REPOSITORY_GROUP \
    --project=PROJECT_ID \
    --location=REGION \
    --code-repository-index=INDEX_NAME \
    --repositories=FILEPATH.json

gcloud gemini code-repository-indexes repository-groups create REPOSITORY_GROUP \
    --project=PROJECT_ID \
    --location=REGION \
    --code-repository-index=INDEX_NAME \
    --repositories=FILEPATH.yaml

หากต้องการ คุณสามารถเข้ารหัสและควบคุมข้อมูลด้วยคีย์การเข้ารหัสที่จัดการโดยลูกค้า (CMEK) ผ่าน Cloud Key Management Service ได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้ CMEK ได้ที่เข้ารหัสข้อมูลด้วยคีย์การเข้ารหัสที่จัดการโดยลูกค้า

มอบบทบาท IAM ให้กับกลุ่มที่เก็บในโปรเจ็กต์

คุณจะได้รับคำแนะนำจากที่เก็บในดัชนีเท่านั้น แต่ละ ที่เก็บจะเป็นของกลุ่มที่เก็บอย่างน้อย 1 กลุ่ม หากต้องการเข้าถึงคำแนะนำ คุณต้องให้บทบาท IAM ของผู้ใช้กลุ่มที่เก็บ Cloud AI Companion (roles/cloudaicompanion.repositoryGroupsUser) ซึ่งมีสิทธิ์ cloudaicompanion.repositoryGroups.user IAM ที่จำเป็นแก่กลุ่มที่เก็บ โดยทำอย่างใดอย่างหนึ่งต่อไปนี้

• ให้สิทธิ์หลักในการเข้าถึงดัชนีทั้งหมด

• ให้สิทธิ์เข้าถึงผู้ใช้หลักในดัชนีย่อย

  bindings:
  - members:
    - group:my-group@example.com
    - user:test-user@example.com
    role: roles/cloudaicompanion.repositoryGroupsUser

  gcloud gemini code-repository-indexes repository-groups set-iam-policy GROUP_NAMEPOLICY_FILE \
      --project=PROJECT_ID \
      --location=REGION \
      --code-repository-index=INDEX_NAME

ตรวจสอบว่าคุณได้กำหนดค่า Developer Connect และเชื่อมต่อกับที่เก็บแล้ว

• GitHub.com
• GitLab.com
• Bitbucket.org

สร้างดัชนี การปรับแต่งโค้ดอาศัยดัชนีในการวิเคราะห์และแยกวิเคราะห์ ที่เก็บของคุณเพื่อให้คำแนะนำในการสร้างโค้ดและการค้นหาที่รวดเร็วขึ้น

resource "google_gemini_code_repository_index" "example" {
  location = "REGION"
  code_repository_index_id = "INDEX_NAME"
}

แทนที่ค่าต่อไปนี้

• INDEX_NAME: ชื่อดัชนี สำคัญ จดชื่อดัชนีไว้ คุณจะต้องใช้รหัสนี้ในหลายขั้นตอนในเอกสารนี้
• PROJECT_ID: รหัสโปรเจ็กต์ Google Cloud
• REGION: ภูมิภาคที่กำหนดค่าใน Developer Connect ในโปรเจ็กต์ Cloud คุณต้องระบุภูมิภาคที่รองรับเพื่อให้คำสั่งสำเร็จ

โดยทั่วไปการสร้างดัชนีจะใช้เวลา 30 นาที แต่บางครั้งอาจใช้เวลาถึง 1 ชั่วโมง

Google จำกัดจำนวนดัชนีที่เก็บโค้ดไว้ที่ 1 รายการสำหรับแต่ละโปรเจ็กต์และองค์กร

ควบคุมการเข้าถึงดัชนีโดยใช้กลุ่มที่เก็บ กลุ่มที่เก็บ คือคอนเทนเนอร์สำหรับการกำหนดค่าการจัดทำดัชนี ซึ่งรวมถึงที่เก็บ และรูปแบบสาขาของที่เก็บ กลุ่มที่เก็บได้รับการออกแบบมาเพื่อการควบคุม IAM แบบละเอียด ซึ่งช่วยให้นักพัฒนาซอฟต์แวร์เข้าถึงข้อมูลที่จัดทำดัชนี จากกลุ่มเหล่านั้นได้เมื่อมีcloudaicompanion.repositoryGroups.useสิทธิ์

กลุ่มที่เก็บมีที่เก็บ Developer Connect หรือลิงก์จากโปรเจ็กต์และตำแหน่งเดียวกัน

ผู้ดูแลระบบจะดำเนินการต่อไปนี้

• สร้างทรัพยากรดัชนีที่เก็บโค้ด
• กำหนดค่าการเชื่อมต่อ Developer Connect ใหม่ในโปรเจ็กต์และตำแหน่งเดียวกัน
• ลิงก์ที่เก็บ Git ในการเชื่อมต่อ
• รับชื่อทรัพยากรของลิงก์ เลือกรูปแบบสาขาที่จะจัดทำดัชนีสำหรับแต่ละลิงก์ และวางไว้ในกลุ่มที่เก็บอย่างน้อย 1 กลุ่ม

resource "google_gemini_repository_group" "example" {
  location = "REGION"
  code_repository_index = "INDEX_NAME"
  repository_group_id = "REPOSITORY_GROUP"
  repositories {
    resource = "REPOSITORY_RESOURCE_NAME"
    branch_pattern = "BRANCH_NAMES"
  }
}

แทนที่ค่าต่อไปนี้

• REPOSITORY_GROUP: ชื่อกลุ่มที่เก็บ เช่น default
• REPOSITORY_RESOURCE_NAME: ชื่อของที่เก็บ ในการเชื่อมต่อ Developer Connect หากต้องการค้นหาชื่อ ที่เก็บ ให้ไปที่หน้าที่เก็บ Git ใน Google Cloud Console แล้วในแท็บที่เก็บ ให้มองหา รหัสการเชื่อมต่อในคอลัมน์การเชื่อมต่อในตาราง หากต้องการคัดลอกชื่อทรัพยากร ให้คลิกเมนู more_vert เพื่อดูตัวเลือกเพิ่มเติม แล้ว เลือกคัดลอกเส้นทางทรัพยากร
• BRANCH_NAMES: ชื่อสาขาที่คุณต้องการ จัดทำดัชนี เช่น main|dev

นอกจากนี้ คุณยังสร้างกลุ่มที่เก็บด้วยที่เก็บที่กำหนดไว้ในไฟล์ JSON (หรือ YAML) ซึ่งจัดรูปแบบดังนี้ได้ด้วย

[
  {
      "resource": "REPOSITORY_RESOURCE_NAME", "branchPattern": "main|dev"
  },
  {
      "resource": "REPOSITORY_RESOURCE_NAME", "branchPattern": "dev"
  }
]

- resource: REPOSITORY_RESOURCE_NAME
  branchPattern: main|dev

- resource: REPOSITORY_RESOURCE_NAME
  branchPattern: dev

หากต้องการสร้างกลุ่มที่เก็บตามไฟล์ JSON หรือ YAML ในสภาพแวดล้อมเชลล์ ให้ใช้คำสั่ง gemini code-repository-indexes repository-groups create

gcloud gemini code-repository-indexes repository-groups create REPOSITORY_GROUP \
    --project=PROJECT_ID \
    --location=REGION \
    --code-repository-index=INDEX_NAME \
    --repositories=FILEPATH.json

gcloud gemini code-repository-indexes repository-groups create REPOSITORY_GROUP \
    --project=PROJECT_ID \
    --location=REGION \
    --code-repository-index=INDEX_NAME \
    --repositories=FILEPATH.yaml

หากต้องการ คุณสามารถเข้ารหัสและควบคุมข้อมูลด้วยคีย์การเข้ารหัสที่จัดการโดยลูกค้า (CMEK) ผ่าน Cloud Key Management Service ได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้ CMEK ได้ที่เข้ารหัสข้อมูลด้วยคีย์การเข้ารหัสที่จัดการโดยลูกค้า

มอบบทบาท IAM ให้กับกลุ่มที่เก็บในโปรเจ็กต์

คุณจะได้รับคำแนะนำจากที่เก็บในดัชนีเท่านั้น แต่ละ ที่เก็บจะเป็นของกลุ่มที่เก็บอย่างน้อย 1 กลุ่ม หากต้องการเข้าถึงคำแนะนำ คุณต้องให้บทบาท IAM ของผู้ใช้กลุ่มที่เก็บ Cloud AI Companion (roles/cloudaicompanion.repositoryGroupsUser) ซึ่งมีสิทธิ์ cloudaicompanion.repositoryGroups.user IAM ที่จำเป็นแก่กลุ่มที่เก็บ โดยทำอย่างใดอย่างหนึ่งต่อไปนี้

• ให้สิทธิ์หลักในการเข้าถึงดัชนีทั้งหมด

• ให้สิทธิ์เข้าถึงผู้ใช้หลักในดัชนีย่อย

  data "google_iam_policy" "foo" {
    binding {
      role = "roles/cloudaicompanion.repositoryGroupsUser"
      members = ["test-user@example.com"]
    }
  }

  resource "google_gemini_repository_group_iam_policy" "foo" {
    project = "PROJECT_ID"
    location = "REGION"
    code_repository_index_id = "INDEX_NAME"
    repository_group_id = "GROUP_NAME"
    policy_data = data.google_iam_policy.foo.policy_data
  }

  data "google_gemini_repository_group_iam_policy" "foo" {
    project = "PROJECT_ID"
    location = "REGION"
    code_repository_index_id = "INDEX_NAME"
    repository_group_id = "GROUP_NAME"
    depends_on = [
      google_gemini_repository_group_iam_policy.foo
    ]
  }

  resource "google_gemini_repository_group_iam_binding" "foo" {
    project = "PROJECT_ID"
    location = "REGION"
    code_repository_index_id = "INDEX_NAME"
    repository_group_id = "GROUP_NAME"
    role = "roles/cloudaicompanion.repositoryGroupsUser"
    members = ["test-user@example.com"]
  }

ใน Google Cloud Console ให้ไปที่หน้าผลิตภัณฑ์ Gemini

ไปที่ผลิตภัณฑ์ Gemini

ระบบจะโหลดหน้าผลิตภัณฑ์ Gemini

ในเมนูการนำทาง ให้คลิกการปรับแต่งโค้ด

ระบบจะโหลดหน้าการปรับแต่งโค้ด

หากต้องการลบดัชนี ให้คลิกลบ

ข้อความเตือนจะแสดงขึ้น หากต้องการดำเนินการต่อและลบดัชนี ให้ป้อนชื่อดัชนี แล้วคลิกลบ

หากต้องการแสดงรายการกลุ่มที่เก็บทั้งหมดสำหรับดัชนีปัจจุบันในสภาพแวดล้อมเชลล์ ให้ใช้gemini code-repository-indexes repository-groups list คำสั่ง

gcloud gemini code-repository-indexes repository-groups list --location=REGION \
    --project=PROJECT_ID \
    --code-repository-index=INDEX_NAME --uri

แทนที่ค่าต่อไปนี้

• REGION: ภูมิภาคที่กำหนดค่าใน Developer Connect ในโปรเจ็กต์ Cloud คุณต้องระบุภูมิภาคที่รองรับเพื่อให้คำสั่งสำเร็จ
• PROJECT_ID: รหัสโปรเจ็กต์ Google Cloud
• INDEX_NAME: ชื่อของดัชนีที่คุณสร้างในขั้นตอนก่อนหน้าเพื่อสร้างดัชนี

หากต้องการลบกลุ่มที่เก็บออกจากดัชนีปัจจุบัน ให้ใช้คำสั่ง gemini code-repository-indexes repository-groups delete

gcloud gemini code-repository-indexes repository-groups delete REPOSITORY_GROUP \
    --location=REGION \
    --project=PROJECT_ID \
    --code-repository-index=INDEX_NAME

ทำขั้นตอนก่อนหน้าซ้ำสำหรับกลุ่มที่เก็บแต่ละกลุ่มจนกว่าจะลบกลุ่มที่เก็บทั้งหมดออกจากดัชนี

ไม่บังคับ: หากต้องการลบดัชนี ให้ใช้gemini code-repository-indexes deleteคำสั่งในสภาพแวดล้อมเชลล์

gcloud gemini code-repository-indexes delete INDEX_NAME \
    --location=REGION \
    --project=PROJECT_ID