登录

控制台

在新浏览器标签页中打开以下网址，以访问 Distributed Cloud 界面 (UI)：

https://GDC_URL

将 GDC_URL 替换为用于访问基础设施运营商 (IO) 提供的 Distributed Cloud 的网域名称。首次打开任何网址时，如果基础设施运维人员 (IO) 配置了该网页，Distributed Cloud 会将您重定向到身份提供方登录页面。

例如，下图展示了如何登录名为 org-1 的组织的控制台界面：

CLI

登录 gdcloud CLI 时，您可以使用 gdcloud auth login 命令向 gdcloud CLI 进行主账号的身份验证。gcloud CLI 会使用该主账号进行身份验证和授权，以管理 Google Cloud 资源和服务。

在登录之前，请确保您已完成以下操作：

• 下载 gdcloud CLI 二进制文件并将其安装到您的系统中。如需了解详情，请参阅下载 gdcloud CLI。
• 设置并初始化 gdcloud CLI 默认配置。请务必设置正确的组织网址，该网址用于提取登录配置端点。如需了解详情，请参阅 gdcloud CLI 安装。
• 安装身份验证插件 gdcloud-k8s-auth-plugin。如需了解详情，请参阅 gcloud CLI 身份验证。

如需登录管理 API 服务器或 Kubernetes 集群，请完成以下步骤：

• 管理 API 服务器：

1. 导出您要存储 Management API 服务器 kubeconfig 文件的路径：

   export KUBECONFIG=MANAGEMENT_API_SERVER
   

   将 MANAGEMENT_API_SERVER 替换为用于存储 kubeconfig 文件的目录的路径。

2. 对您的 gdcloud CLI 实例进行身份验证以登录。您可以通过以下两种方式进行身份验证：

   • 标准浏览器登录：从浏览器登录时使用此身份验证流程。

     gdcloud auth login
     

   • 辅助设备登录：如果您的主设备没有可用的浏览器，请使用此身份验证流程。此流程在无法访问浏览器的主设备上启动登录，然后通过可访问浏览器的辅助设备继续登录。

     在没有浏览器的主设备上启动登录：

     gdcloud auth login --no-browser
     

     KUBECONFIG 环境变量会更新为组织中所有 API 服务器和集群的 kubeconfig 文件。如果未设置 KUBECONFIG 变量，kubectl CLI 会使用存储在 $HOME/.kube/config 中的默认 kubeconfig 文件。

     如需跳过修改 kubeconfig 文件，请在命令中添加 --skip-kubeconfig-update 标志。例如：

     gdcloud auth login --no-browser --skip-kubeconfig-update
     

     复制打印出的 gdcloud CLI 命令输出，然后在有权访问浏览器的机器上运行该命令。

3. 按照网页上的说明完成登录流程。

   成功完成登录后，浏览器会显示消息身份验证成功。请关闭此窗口。

4. 按照终端上的说明操作。成功登录后，终端会显示消息：You are now logged in。

• Kubernetes 集群：

1. 对您的 gdcloud CLI 实例进行身份验证以登录。您可以通过以下两种方式进行身份验证：

   • 标准浏览器登录：从浏览器登录时使用此身份验证流程。

     gdcloud auth login
     

   • 辅助设备登录：如果您的主设备没有可用的浏览器，请使用此身份验证流程。此流程在无法访问浏览器的主设备上启动登录，然后通过可访问浏览器的辅助设备继续登录。

     1. 在没有浏览器的主设备上启动登录：

        gdcloud auth login --no-browser
        

        主设备中的命令会输出另一个 gdcloud 命令，您必须在步骤 c 中在辅助设备上运行该命令。

     2. 重复第 1 步，在辅助设备上下载证书。

     3. 在辅助设备上输入在步骤 a 中主设备上显示的命令，完成登录。

   此操作会打开一个浏览器，以便登录配置的身份提供商 (IdP)。提供您在初始 gdcloud CLI 设置期间设置的用户名和密码以进行登录。

2. 将您的用户身份 kubeconfig 文件导出为变量：

   export KUBECONFIG=/tmp/admin-kubeconfig-with-user-identity.yaml
   

3. 使用您的用户身份生成 kubeconfig 文件：

   gdcloud clusters get-credentials CLUSTER_NAME --zone ZONE
   

   将 ZONE 替换为可用区名称。

   系统会生成一个包含您的用户身份信息的 kubeconfig 文件。 以下 YAML 文件显示了一个示例：

   apiVersion: v1
   clusters:
   - cluster:
     certificate-authority-data: <REDACTED>
     server: https://10.200.0.32:443
   name: cluster-name
   contexts:
   - context:
     cluster: cluster-name
     user: cluster-name-anthos-default-user
   name: cluster-name-cluster-name-anthos-default-user
   current-context: cluster-name-cluster-name-anthos-default-user
   kind: Config
   preferences: {}
   users:
   - name: cluster-name-anthos-default-user
   user:
     exec:
       apiVersion: client.authentication.k8s.io/v1
       args:
       - --audience=root-admin
       command: gdcloud-k8s-auth-plugin
       env: null
       installHint: Run 'gdcloud components install gdcloud-k8s-auth-plugin' to use plugin
       interactiveMode: Never
       provideClusterInfo: false
   

4. 如需验证您是否可以访问集群，请使用生成的 kubeconfig 文件以用户身份登录：

   kubectl --kubeconfig /tmp/admin-kubeconfig-with-user-identity.yaml version
   

控制台

点击菜单栏中的 logout 退出。

CLI

从 CLI 退出：

gdcloud auth revoke

控制台

对于会话闲置，GDC 控制台会将您退出登录。在 GDC 控制台因您未做任何操作而将您退出登录前两分钟，您会收到一个对话框，其中会提醒您即将退出登录：

在因闲置而将您退出账号后，您会看到以下界面：

如需重新登录 GDC 控制台，请选择您的身份提供方并添加您的登录凭据。如果您使用监控信息中心等服务，并且 GDC 控制台因您处于不活动状态而将您退出，请重新登录以获取访问权限。

gdcloud

如果会话处于不活跃状态，gcloud CLI 会将您退出。在 gdcloud CLI 将您退出登录后，如果您尝试运行命令，则会收到授权错误：

Error: error when creating kube client: unable to create k8sclient: Unauthorized

如需重新登录 GDC，请按照登录中的 CLI 步骤操作。

如果您通过 Management API 服务器重新登录 GDC，您的 kubeconfig 文件会自动更新。为避免 kubeconfig 文件更新，请在 gdcloud auth login 命令中使用 --skip-kubeconfig-update 标志。

kubectl

gdcloud CLI 会在会话处于不活动状态一段时间后使您的 kubeconfig 文件过期。如果您在不活动一段时间后尝试运行 kubectl 命令，则会收到授权错误：

error: You must be logged in to the server (Unauthorized)

如需重新登录并使用 kubeconfig 文件，请按照登录中的 CLI 步骤操作。每次会话超时后，您都必须重新生成 kubeconfig 文件。