سفارشی‌سازی کد Gemini Code Assist را پیکربندی کنید

این سند نحوه تنظیم سفارشی‌سازی کد Gemini Code Assist را در کنسول Google Cloud، با رابط خط فرمان Google Cloud یا با Terraform با اتصال Gemini Code Assist به مخازن کد خصوصی شما شرح می‌دهد. ویژگی سفارشی‌سازی کد Gemini Code Assist به شما امکان می‌دهد توصیه‌های کد را دریافت کنید که از کتابخانه‌های داخلی، APIهای خصوصی و سبک کدنویسی سازمان شما استخراج می‌شوند.

قبل از اینکه شروع کنی

  1. Gemini Code Assist را با اشتراک Enterprise راه‌اندازی کنید .

  2. تأیید کنید که نقش‌های مدیریت هویت و دسترسی زیر را در پروژه‌ای که اشتراک را در اختیار دارد، دارید:

    • مدیر ایندکس‌های مخزن کد ( roles/cloudaicompanion.codeRepositoryIndexesAdmin )
    • Gemini برای کاربر Google Cloud ( roles/cloudaicompanion.user )

  3. ایجاد یا پیکربندی حساب‌های کاربری. هر توسعه‌دهنده‌ای در سازمان شما که از Gemini Code Assist استفاده می‌کند، باید یک هویت کاربری در Google Cloud داشته باشد که اجازه دسترسی به پروژه Google Cloud شما را داشته باشد. برای اطلاعات بیشتر، به بخش اعطای نقش‌ها در کنسول Google Cloud مراجعه کنید. تأیید کنید که هر کاربر نقش‌های زیر را دارد:

  4. ویژگی سفارشی‌سازی کد از Developer Connect برای دسترسی و فهرست‌بندی مخازن خصوصی شما استفاده می‌کند. اطمینان حاصل کنید که منطقه Developer Connect که اتصال مخزن Developer Connect شما در آن قرار دارد، یک مکان پشتیبانی‌شده برای سفارشی‌سازی کد نیز باشد. اگر اتصال Developer Connect در یک منطقه پشتیبانی‌نشده باشد، نمی‌توان از ویژگی سفارشی‌سازی کد استفاده کرد. برای لیست مناطق پشتیبانی‌شده، به محدودیت‌های سفارشی‌سازی کد مراجعه کنید.

انتخاب کنید کدام مخازن ایندکس شوند

به عنوان یک روش برتر، شما باید مخازنی را فهرست‌بندی کنید که ویژگی‌های زیر را داشته باشند:

  • کدی که سبک یا ساختار مشابهی با آنچه می‌خواهید توسعه‌دهندگانتان بنویسند، داشته باشد.
  • کتابخانه‌های خصوصی یا APIهایی که می‌خواهید از پایگاه کد فعلی خود فراخوانی کنید.

اختیاری: انتخاب کنید کدام فایل‌ها ایندکس نشوند

به طور پیش‌فرض، سفارشی‌سازی کد، تمام فایل‌های کد پشتیبانی‌شده در مخازن مشخص‌شده شما را فهرست‌بندی می‌کند.

برای جلوگیری از افشای کدی که نمی‌خواهید ایندکس شود، می‌توانید از الگوهای شاخه‌بندی برای کنترل دسترسی به ایندکس خود استفاده کنید و از یک شاخه پایدار مانند main استفاده کنید.

همچنین می‌توانید با ایجاد یک فایل .aiexclude ، فایل‌ها را از فهرست‌بندی حذف کنید.

پیکربندی سفارشی‌سازی کد Gemini Code Assist

یکی از گزینه‌های زیر را انتخاب کنید:

کنسول

  1. در کنسول گوگل کلود، به صفحه سفارشی‌سازی کد بروید.

    برای کمک به کد Gemini به سفارشی‌سازی کد بروید

    صفحه شخصی‌سازی کد برای Gemini Code Assist بارگذاری می‌شود.

  2. ایجاد یک فهرست. سفارشی‌سازی کد برای تجزیه و تحلیل مخزن شما و ارائه پیشنهادات و جستجوهای سریع‌تر برای تولید کد، به یک فهرست متکی است.

    1. روی ایجاد کلیک کنید و جزئیات فهرست را پیکربندی کنید:

      • منطقه‌ای را که در Developer Connect در پروژه Cloud شما پیکربندی شده است، انتخاب کنید.
      • یک نام برای فهرست خود وارد کنید. نام فهرست خود را یادداشت کنید. در چندین مرحله از این سند به آن نیاز دارید.

    2. روی ایجاد کلیک کنید.

    ایجاد ایندکس معمولاً 30 دقیقه طول می‌کشد، اما ممکن است تا یک ساعت هم طول بکشد. وقتی ایندکس‌گذاری تمام شد، در کنسول گوگل کلود یک اعلان دریافت خواهید کرد.

    گوگل تعداد ایندکس‌های مخزن کد را برای هر پروژه و سازمان به یک عدد محدود می‌کند.

  3. دسترسی به فهرست خود را با استفاده از گروه‌های مخزن کنترل کنید.

    یک گروه مخزن، ظرفی برای پیکربندی نمایه‌سازی است که شامل مخازن و الگوهای شاخه‌بندی آنها می‌شود. گروه‌های مخزن برای کنترل IAM دانه‌ای طراحی شده‌اند و به توسعه‌دهندگان امکان دسترسی به داده‌های نمایه‌سازی شده از آن گروه‌ها را می‌دهند، جایی که آنها مجوز cloudaicompanion.repositoryGroups.use را دارند.

    گروه‌های مخزن شامل مخازن یا پیوندهای Developer Connect از همان پروژه و مکان هستند.

  4. در صفحه سفارشی‌سازی کد برای Gemini Code Assist ، روی Add repositories کلیک کنید و سپس Add source repositories را انتخاب کنید.

    فهرستی از مخازن موجود در Developer Connect برای منطقه‌ای که در مرحله قبل برای ایجاد ایندکس پیکربندی کرده‌اید، نمایش داده می‌شود.

    اگر نیاز به اضافه کردن مخازن جدید به گروه مخزن دارید، روی پیوند مخزن کلیک کنید و مراحل موجود در کنسول Google Cloud را دنبال کنید.

    علاوه بر این، می‌توانید یک یا چند مخزن را انتخاب و سپس ویرایش کنید تا یک شاخه جدید اضافه شود.

  5. گروه مخزنی را که می‌خواهید مخازن جدید به آن اضافه کنید، انتخاب کنید. همچنین می‌توانید برای ایجاد و پیکربندی یک گروه مخزن جدید، روی «ایجاد یک گروه مخزن جدید» کلیک کنید.

  6. برای شروع فهرست‌بندی مخازن انتخاب‌شده، روی فهرست‌بندی کلیک کنید.

    زمان ایندکس شدن بسته به اندازه مخازن متفاوت است.

رابط خط فرمان

  1. تأیید کنید که Developer Connect را پیکربندی کرده و به مخزن خود متصل شده‌اید:

  2. در یک محیط shell، دستور gcloud components update را اجرا کنید تا تأیید کنید که تمام اجزای نصب شده gcloud را به آخرین نسخه به‌روزرسانی کرده‌اید. برای این مرحله، می‌توانید gcloud را نصب و راه‌اندازی کنید، یا می‌توانید از Cloud Shell Editor استفاده کنید.

    gcloud components update

  3. ایجاد یک فهرست. سفارشی‌سازی کد برای تجزیه و تحلیل مخزن شما و ارائه پیشنهادات و جستجوهای سریع‌تر برای تولید کد، به یک فهرست متکی است.

    1. برای ایجاد ایندکس، در یک محیط shell، از دستور gemini code-repository-indexes create استفاده کنید:

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

      موارد زیر را جایگزین کنید:

      • INDEX_NAME : نام ایندکس شما. مهم : نام ایندکس خود را یادداشت کنید. در چندین مرحله از این سند به آن نیاز دارید.
      • PROJECT_ID : شناسه پروژه گوگل کلود شما.
      • REGION : منطقه‌ای که در Developer Connect در پروژه Cloud شما پیکربندی شده است. برای موفقیت دستورات، باید یک منطقه پشتیبانی شده را مشخص کنید.

      ایجاد فهرست معمولاً 30 دقیقه طول می‌کشد، اما ممکن است تا یک ساعت هم طول بکشد.

      گوگل تعداد ایندکس‌های مخزن کد را برای هر پروژه و سازمان به یک عدد محدود می‌کند.

  4. دسترسی به فهرست خود را با استفاده از گروه‌های مخزن کنترل کنید. یک گروه مخزن، ظرفی برای پیکربندی فهرست‌بندی است که شامل مخازن و الگوهای شاخه‌های آنها می‌شود. گروه‌های مخزن برای کنترل IAM دانه‌ای طراحی شده‌اند و به توسعه‌دهندگان امکان دسترسی به داده‌های فهرست‌بندی شده از آن گروه‌ها را می‌دهند، جایی که آنها مجوز cloudaicompanion.repositoryGroups.use را دارند.

    گروه‌های مخزن شامل مخازن یا پیوندهای Developer Connect از همان پروژه و مکان هستند.

    مدیران اقدامات زیر را انجام می‌دهند:

    • منبع فهرست مخزن کد را ایجاد کنید.
    • در همان پروژه و مکان، یک اتصال Developer Connect جدید پیکربندی کنید.
    • مخازن گیت را در اتصال لینک کنید.
    • نام منابع لینک‌ها را دریافت کنید، الگوی شاخه را برای اندیس‌گذاری هر لینک انتخاب کنید و آن را در یک یا چند گروه مخزن قرار دهید.

    برای ایجاد یک گروه مخزن، در یک محیط shell، از دستور 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 بروید و در تب Repositories ، به دنبال Connection ID در زیر ستون Connection در جدول بگردید. برای کپی کردن نام منبع، برای گزینه‌های بیشتر روی منوی more_vert کلیک کنید و Copy resource path را انتخاب کنید.
    • 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، در یک محیط shell، از دستور 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) از طریق سرویس مدیریت کلید ابری رمزگذاری و کنترل کنید. برای کسب اطلاعات بیشتر در مورد استفاده از CMEK، به بخش رمزگذاری داده‌ها با کلیدهای رمزگذاری مدیریت‌شده توسط مشتری مراجعه کنید.

  5. نقش‌های IAM را به گروه مخزن در یک پروژه اعطا کنید.

    شما فقط پیشنهادات را از مخازن موجود در فهرست دریافت می‌کنید. هر مخزن به یک یا چند گروه مخزن تعلق دارد. برای دسترسی به پیشنهادات، باید نقش IAM کاربر Cloud AI Companion Repository Groups ( roles/cloudaicompanion.repositoryGroupsUser ) - که شامل مجوز IAM مورد نیاز cloudaicompanion.repositoryGroups.user است - را به یکی از روش‌های زیر به گروه مخزن اعطا کنید:

    • به مدیران اصلی اجازه دسترسی به کل فهرست را بدهید.

    • به مدیران اصلی (Principal) اجازه دسترسی به زیرمجموعه‌ای از شاخص را بدهید.

    کل شاخص

    1. برای اتصال یک سیاست IAM برای یک پروژه، در یک محیط shell، از دستور projects add-iam-policy-binding استفاده کنید:

      gcloud projects add-iam-policy-binding PROJECT_ID \
    --member='PRINCIPAL' \
    --role='roles/cloudaicompanion.repositoryGroupsUser'

      موارد زیر را جایگزین کنید:

      • PRINCIPAL : آدرس ایمیل مدیر اصلی که نیاز به دسترسی دارد - برای مثال، user:test-user@gmail.com برای یک فرد، یا group:admins@example.com برای یک گروه.

      برای اطلاعات بیشتر، gcloud projects set-iam-policy مراجعه کنید.

    2. وقتی از شما خواسته شد شرطی را مشخص کنید، None را وارد کنید.

    زیرمجموعه شاخص

    شما می‌توانید چندین گروه مخزن ایجاد کنید و نقش‌های IAM را به مدیران IAM مختلف اختصاص دهید.

    برای تنظیم یک سیاست IAM، باید فایل JSON یا YAML سیاست IAM را تهیه کنید که شامل لیستی از گروه‌های IAM و نقش‌های اختصاص داده شده خواهد بود. به عنوان مثال:

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

    برای جزئیات بیشتر و نحو، به درک سیاست‌های مجاز مراجعه کنید.

    برای تنظیم سیاست IAM، در یک محیط shell، از دستور gemini code-repository-indexes repository-groups set-iam-policy استفاده کنید: 

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

    موارد زیر را جایگزین کنید:

    • GROUP_NAME : نام گروه مخزنی که در مرحله قبل برای کنترل دسترسی به فهرست خود با استفاده از گروه‌های مخزن ایجاد کرده‌اید.

    • POLICY_FILE : سیاست IAM.

      برای اطلاعات بیشتر، به gcloud gemini code-repository-indexes repository-groups set-iam-policy مراجعه کنید.

ترافرم

  1. تأیید کنید که Developer Connect را پیکربندی کرده و به مخزن خود متصل شده‌اید:

  2. ایجاد یک فهرست. سفارشی‌سازی کد برای تجزیه و تحلیل مخزن شما و ارائه پیشنهادات و جستجوهای سریع‌تر برای تولید کد، به یک فهرست متکی است. 

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

    موارد زیر را جایگزین کنید:

    • INDEX_NAME : نام ایندکس شما. مهم : نام ایندکس خود را یادداشت کنید. در چندین مرحله از این سند به آن نیاز دارید.
    • PROJECT_ID : شناسه پروژه گوگل کلود شما.
    • REGION : منطقه‌ای که در Developer Connect در پروژه Cloud شما پیکربندی شده است. برای موفقیت دستورات، باید یک منطقه پشتیبانی شده را مشخص کنید.

    ایجاد فهرست معمولاً 30 دقیقه طول می‌کشد، اما ممکن است تا یک ساعت هم طول بکشد.

    گوگل تعداد ایندکس‌های مخزن کد را برای هر پروژه و سازمان به یک عدد محدود می‌کند.

  3. دسترسی به فهرست خود را با استفاده از گروه‌های مخزن کنترل کنید. یک گروه مخزن، ظرفی برای پیکربندی فهرست‌بندی است که شامل مخازن و الگوهای شاخه‌های آنها می‌شود. گروه‌های مخزن برای کنترل IAM دانه‌ای طراحی شده‌اند و به توسعه‌دهندگان امکان دسترسی به داده‌های فهرست‌بندی شده از آن گروه‌ها را می‌دهند، جایی که آنها مجوز cloudaicompanion.repositoryGroups.use را دارند.

    گروه‌های مخزن شامل مخازن یا پیوندهای Developer Connect از همان پروژه و مکان هستند.

    مدیران اقدامات زیر را انجام می‌دهند:

    • منبع فهرست مخزن را با کد ایجاد کنید.
    • در همان پروژه و مکان، یک اتصال Developer Connect جدید پیکربندی کنید.
    • مخازن گیت را در اتصال لینک کنید.
    • نام منابع لینک‌ها را دریافت کنید، الگوی شاخه را برای اندیس‌گذاری هر لینک انتخاب کنید و آن را در یک یا چند گروه مخزن قرار دهید. 
    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 بروید و در تب Repositories ، به دنبال Connection ID در زیر ستون Connection در جدول بگردید. برای کپی کردن نام منبع، برای گزینه‌های بیشتر روی منوی more_vert کلیک کنید و Copy resource path را انتخاب کنید.
    • 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، در یک محیط shell، از دستور 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) از طریق سرویس مدیریت کلید ابری رمزگذاری و کنترل کنید. برای کسب اطلاعات بیشتر در مورد استفاده از CMEK، به بخش رمزگذاری داده‌ها با کلیدهای رمزگذاری مدیریت‌شده توسط مشتری مراجعه کنید.

  4. نقش‌های IAM را به گروه مخزن در یک پروژه اعطا کنید.

    شما فقط پیشنهادات را از مخازن موجود در فهرست دریافت می‌کنید. هر مخزن به یک یا چند گروه مخزن تعلق دارد. برای دسترسی به پیشنهادات، باید نقش IAM کاربر Cloud AI Companion Repository Groups ( roles/cloudaicompanion.repositoryGroupsUser ) - که شامل مجوز IAM مورد نیاز cloudaicompanion.repositoryGroups.user است - را به یکی از روش‌های زیر به گروه مخزن اعطا کنید:

    • به مدیران اصلی اجازه دسترسی به کل فهرست را بدهید.

    • به مدیران اصلی (Principal) اجازه دسترسی به زیرمجموعه‌ای از شاخص را بدهید.

    کل شاخص

    1. برای اتصال یک سیاست IAM برای یک پروژه، در یک محیط shell، از دستور projects add-iam-policy-binding استفاده کنید: 

      gcloud projects add-iam-policy-binding PROJECT_ID \
    --member='PRINCIPAL' \
    --role='roles/cloudaicompanion.repositoryGroupsUser'

      موارد زیر را جایگزین کنید:

      • PRINCIPAL : آدرس ایمیل مدیر اصلی که نیاز به دسترسی دارد - برای مثال، user:test-user@gmail.com برای یک فرد، یا group:admins@example.com برای یک گروه.

        برای اطلاعات بیشتر، gcloud projects set-iam-policy مراجعه کنید.

    2. وقتی از شما خواسته شد شرطی را مشخص کنید، None را وارد کنید.

    زیرمجموعه شاخص

    شما می‌توانید چندین گروه مخزن ایجاد کنید و نقش‌های IAM را به مدیران 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"]
  }

    موارد زیر را جایگزین کنید:

    • GROUP_NAME : نام گروه مخزنی که در مرحله قبل برای کنترل دسترسی به فهرست خود با استفاده از گروه‌های مخزن ایجاد کرده‌اید.

بررسی وضعیت ایندکس شدن

بسته به تعداد مخازنی که می‌خواهید ایندکس کنید و اندازه آنها، ایندکس کردن محتوا می‌تواند تا ۲۴ ساعت طول بکشد. برای مخازن بزرگ، ایندکس کردن می‌تواند بیشتر طول بکشد. ایندکس کردن هر ۲۴ ساعت یک بار اتفاق می‌افتد و هرگونه تغییری که در مخزن ایجاد شده است را ثبت می‌کند.

  1. برای اطلاعات بیشتر، به بخش «زبان پرس‌وجوی indexing وقایع» مراجعه کنید.

    کنسول

    1. در کنسول گوگل کلود، به Logs Explorer بروید.

      به کاوشگر گزارش‌ها بروید

    2. برای مشاهده لاگ‌های indexing از فیلتر نام لاگ‌ها استفاده کنید.

    رابط خط فرمان

    برای جستجوی لاگ‌های ایندکس‌گذاری، در یک محیط shell، از دستور logging read استفاده کنید: 

    gcloud logging read "logName="projects/PROJECT_ID/logs/indexing""

    به جای PROJECT_ID شناسه پروژه‌ای که گروه مخزن در آن قرار دارد را وارد کنید.

    برای مثال، برای مشاهده خطاهای موجود در لاگ‌های indexing ، دستور زیر را اجرا کنید: 

    gcloud logging read "logName="projects/PROJECT_ID/logs/indexing" AND severity>=ERROR"

  2. وضعیت‌های نمایه‌سازی مرتبط، مانند موارد زیر را بررسی کنید:

    • شروع ایندکس‌گذاری مخزن - برای مثال، Indexing repository REPOSITORY_NAME . Total number of repositories: 10, succeeded: 6, failed: 0.
    • پایان فهرست‌بندی مخزن منفرد - برای مثال:
      • موفقیت: Successfully finished indexing repository REPOSITORY_NAME . Total number of repositories: 10, succeeded: 7, failed: 0.
      • خطا: Failed to index repository REPOSITORY_NAME . Error: [<error message>]. Total number of repositories: 10, succeeded: 7, failed: 1.
    • پایان فهرست‌بندی مخزن - برای مثال:
      • موفقیت: Finished indexing process. Repositories attempted: 10. Repositories successfully indexed: 9. Repositories unsuccessfully fetched: 0.
      • شکست: Finished indexing process. Repositories attempted: 10. Repositories successfully indexed: 9. Repositories unsuccessfully fetched: 1. Repositories that were not successfully fetched will be retried in the next run.

    در وضعیت‌های فهرست، REPOSITORY_NAME مخزنی است که می‌خواهید بررسی کنید.

  3. خطاهای مربوط به ایندکس‌گذاری، مانند موارد زیر را بررسی کنید:

    • دریافت مخزن ناموفق بود.
    • فهرست کردن فایل‌های مخزن ناموفق بود.
    • بازیابی اطلاعات مخزن از فهرست انجام نشد.
    • بازیابی فایل‌ها از فهرست انجام نشد.
    • خطای داخلی.

استفاده از سفارشی‌سازی کد

پس از تنظیم سفارشی‌سازی کد، پیشنهادهایی برای تکمیل کد و تولید کد مشاهده خواهید کرد که ممکن است علاوه بر نتایج حاصل از آگاهی کامل از پایگاه داده، بر اساس کد خصوصی که ایندکس کرده‌اید نیز باشند.

توسعه‌دهندگانی که به گروه مخزنی اضافه می‌شوند که حداقل یک منبع در آن فهرست‌بندی شده است، در IDE خود اعلانی مبنی بر فعال شدن سفارشی‌سازی کد دریافت خواهند کرد. برای مشاهده وضعیت سفارشی‌سازی کد، توسعه‌دهندگان می‌توانند روی نماد spark جمینی در گوشه پایین سمت راست کلیک کرده و یکی از وضعیت‌های سفارشی‌سازی کد زیر را در نوار جستجو جستجو کنند:

  • همه چیز آماده است . سفارشی‌سازی کد فعال و پیکربندی شده است.
  • در دسترس نیست . توسعه‌دهنده دسترسی به گروه مخزن را ندارد یا گروه مخزنی که کاربر به آن دسترسی دارد خالی است.
  • غیرفعال . سفارشی‌سازی کد یا فعال نیست یا توسط مدیر پیکربندی نشده است.

برای کسب اطلاعات بیشتر در مورد استفاده از سفارشی‌سازی کد و بهترین شیوه‌ها، به استفاده از سفارشی‌سازی کد مراجعه کنید.

غیرفعال کردن شخصی‌سازی کد

یکی از گزینه‌های زیر را انتخاب کنید:

کنسول

  1. در کنسول گوگل کلود، به صفحه محصولات جمینی بروید.

    به محصولات Gemini بروید

    صفحه محصولات Gemini بارگذاری می‌شود.

  2. در منوی پیمایش، روی سفارشی‌سازی کد کلیک کنید.

    صفحه شخصی‌سازی کد بارگذاری می‌شود.

  3. برای حذف ایندکس، روی حذف کلیک کنید.

    یک پیام هشدار نمایش داده می‌شود. اگر می‌خواهید ادامه دهید و ایندکس را حذف کنید، نام ایندکس را وارد کنید و سپس روی حذف کلیک کنید.

رابط خط فرمان

  1. برای فهرست کردن تمام گروه‌های مخزن برای اندیس فعلی، در یک محیط shell، از دستور 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 : شناسه پروژه گوگل کلود شما.
    • INDEX_NAME : نام اندیسی که در مرحله قبل برای ایجاد اندیس ایجاد کرده‌اید.

  2. برای حذف یک گروه مخزن از فهرست فعلی، از دستور 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

  3. مراحل قبلی را برای هر گروه مخزن تکرار کنید تا زمانی که همه گروه‌های مخزن را از فهرست حذف کنید.

  4. اختیاری: برای حذف اندیس، در محیط shell، از دستور gemini code-repository-indexes delete استفاده کنید: 

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

قدم بعدی چیست؟