第 1 步：设置项目和源代码库

在此步骤中，您将在 Cloud Shell 中设置 Google Cloud 项目和 Python 环境，启用所需的 API，并分配完成本教程所需的 Identity and Access Management (IAM) 角色。您还可以通过分支和克隆 GoogleCloudPlatform/generative-ai 代码库来设置一个包含应用源文件的 GitHub 代码库。完成这些步骤后，您可以通过在 Cloud Shell 中本地运行和测试应用来验证设置。

准备工作

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. Enable the Vertex AI, Compute Engine, Artifact Registry, Identity-Aware Proxy (IAP), Cloud Run Admin, Cloud Build, Identity and Access Management (IAM) API, and Gemini for Google Cloud APIs.

   Enable the APIs

5. Make sure that you have the following role or roles on the project: Vertex AI User, Cloud Build Editor, Cloud Run Admin, Artifact Registry Admin, Compute Load Balancer Admin, Service Account User, IAP Policy Admin, OAuth Config Editor, and Service Usage Admin.

   Check for the roles

   1. In the Google Cloud console, go to the IAM page.

      Go to IAM
   2. Select the project.

   3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

   4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

   Grant the roles

   1. In the Google Cloud console, go to the IAM page.

      进入 IAM
   2. 选择项目。
   3. 点击 授予访问权限。

   4. 在新的主账号字段中，输入您的用户标识符。 这通常是 Google 账号的电子邮件地址。

   5. 在选择角色列表中，选择一个角色。
   6. 如需授予其他角色，请点击 添加其他角色，然后添加其他各个角色。
   7. 点击 Save（保存）。

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

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

   10. Enable the Vertex AI, Compute Engine, Artifact Registry, Identity-Aware Proxy (IAP), Cloud Run Admin, Cloud Build, Identity and Access Management (IAM) API, and Gemini for Google Cloud APIs.

       Enable the APIs

   11. Make sure that you have the following role or roles on the project: Vertex AI User, Cloud Build Editor, Cloud Run Admin, Artifact Registry Admin, Compute Load Balancer Admin, Service Account User, IAP Policy Admin, OAuth Config Editor, and Service Usage Admin.

       Check for the roles

       1. In the Google Cloud console, go to the IAM page.

          Go to IAM
       2. Select the project.

       3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

       4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

       Grant the roles

       1. In the Google Cloud console, go to the IAM page.

          进入 IAM
       2. 选择项目。
       3. 点击 授予访问权限。

       4. 在新的主账号字段中，输入您的用户标识符。 这通常是 Google 账号的电子邮件地址。

       5. 在选择角色列表中，选择一个角色。
       6. 如需授予其他角色，请点击 添加其他角色，然后添加其他各个角色。
       7. 点击 Save（保存）。

       设置源代码库

       1. 在 GitHub 中，复刻 GoogleCloudPlatform/generative-ai 代码库。详细了解如何在 GitHub 中创建分支代码库。

          在 GitHub 中创建代码库分支

       2. In the Google Cloud console, activate Cloud Shell.

          Activate Cloud Shell

          At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

       3. 在 Cloud Shell 终端中，运行以下命令以克隆分支代码库，并将 gemini-streamlit-cloudrun 目录设置为活动目录：
          

          cd
          git clone https://github.com/GIT_USER_NAME/FORK_NAME/
          cd FORK_NAME/gemini/sample-apps/gemini-streamlit-cloudrun

          替换以下内容：

          • GIT_USER_NAME：您的 GitHub 用户名。
          • FORK_NAME：您刚在 GitHub 中创建的分支代码库的名称。

       设置环境和依赖项

       1. 在 Cloud Shell 终端中，运行以下命令以设置虚拟环境：

          python3 -m venv gemini-streamlit
          source gemini-streamlit/bin/activate
          pip install -r requirements.txt
          

       2. 运行以下命令以设置 Vertex AI 初始化所需的环境变量：

          export GCP_PROJECT=$GOOGLE_CLOUD_PROJECT
          export GCP_REGION='us-central1' 
          

       在本地测试应用

       1. 在 Cloud Shell 终端中，运行以下命令以运行应用：

          streamlit run app.py \
            --browser.serverAddress=localhost \
            --server.enableCORS=false \
            --server.enableXsrfProtection=false \
            --server.port 8080
          

       2. 如需预览应用，请在 Cloud Shell 任务栏中点击 ，然后点击在端口 8080 上预览。

          如需详细了解如何使用网页预览功能，请参阅预览 Web 应用。