Looker PSC Южный доступ к Cloud SQL PSC, Looker PSC Южный доступ к Cloud SQL PSC, Looker PSC Южный доступ к Cloud SQL PSC, Looker PSC Южный доступ к Cloud SQL PSC

1. Введение

ПРИМЕЧАНИЕ. Looker поддерживает производителей Southbound в любом регионе. Для северного доступа к Looker конечная точка или серверная часть потребителя должна находиться в том же регионе, что и экземпляр Looker PSC.

В этой лабораторной работе вы выполните подключение на юг к Cloud SQL, развернутому с помощью Private Service Connect в качестве поставщика услуг.

Private Service Connect — это возможность сети Google Cloud, которая позволяет потребителям получать частный доступ к управляемым сервисам изнутри своей сети VPC. Аналогичным образом, это позволяет производителям управляемых услуг размещать эти услуги в своих собственных отдельных сетях VPC и предлагать своим потребителям частное соединение. Например, когда вы используете Private Service Connect для доступа к Looker, вы являетесь потребителем услуги, а Google — производителем услуги, как показано на рисунке 1.

Южный доступ, также известный как обратный PSC, позволяет потребителю создать опубликованную службу в качестве производителя, чтобы обеспечить доступ Looker к локальным конечным точкам, в VPC, к управляемым сервисам и Интернету. Южные соединения могут быть развернуты в любом регионе, независимо от того, где развернут Looker PSC, как показано на рисунке 2.

Что вы узнаете

• Создание службы производителя экземпляра Private Service Connect Cloud SQL
• Создайте конечную точку Private Service Connect в Looker в качестве потребителя услуг.

Что вам понадобится

• Проект Google Cloud с разрешениями владельца
• Существующий экземпляр Looker PSC

2. Что вы будете строить

Вы создадите экземпляр Cloud SQL PSC, развернутый в качестве производителя услуг, связанный с Looker PSC в качестве потребителя услуг.

Следующие действия подтверждают доступ к службе Producer:

• Создайте конечную точку PSC в Looker, связанную с вложением службы производителя.
• Используйте консоль Looker, чтобы создать подключение к базе данных Cloud SQL PSC.
• Проверьте подключение к Cloud SQL PSC, пройдя аутентификацию и получив доступ к предопределенной схеме.

3. Топология Codelab

4. Настройка и требования

Самостоятельная настройка среды

1. Войдите в Google Cloud Console и создайте новый проект или повторно используйте существующий. Если у вас еще нет учетной записи Gmail или Google Workspace, вам необходимо ее создать .

• Имя проекта — это отображаемое имя для участников этого проекта. Это строка символов, не используемая API Google. Вы всегда можете обновить его.
• Идентификатор проекта уникален для всех проектов Google Cloud и является неизменяемым (нельзя изменить после его установки). Cloud Console автоматически генерирует уникальную строку; обычно тебя не волнует, что это такое. В большинстве лабораторий кода вам потребуется указать идентификатор проекта (обычно идентифицируемый как PROJECT_ID ). Если вам не нравится сгенерированный идентификатор, вы можете создать другой случайный идентификатор. Альтернативно, вы можете попробовать свой собственный и посмотреть, доступен ли он. Его нельзя изменить после этого шага и он сохраняется на протяжении всего проекта.
• К вашему сведению, есть третье значение — номер проекта , которое используют некоторые API. Подробнее обо всех трех этих значениях читайте в документации .

Внимание: Идентификатор проекта является глобально уникальным и не может быть использован кем-либо еще после того, как вы его выбрали. Вы единственный пользователь с этим идентификатором. Даже если проект будет удален, идентификатор нельзя будет использовать снова.

Примечание. Если вы используете учетную запись Gmail, вы можете оставить для местоположения по умолчанию значение «Нет организации» . Если вы используете учетную запись Google Workspace, выберите местоположение, подходящее для вашей организации.

2. Затем вам необходимо включить выставление счетов в Cloud Console, чтобы использовать облачные ресурсы/API. Прохождение этой кодовой лаборатории не будет стоить много, если вообще что-то стоить. Чтобы отключить ресурсы и избежать выставления счетов за пределами этого руководства, вы можете удалить созданные вами ресурсы или удалить проект. Новые пользователи Google Cloud имеют право на участие в программе бесплатной пробной версии стоимостью 300 долларов США .

Запустить Cloud Shell

Хотя Google Cloud можно управлять удаленно с вашего ноутбука, в этой лаборатории вы будете использовать Google Cloud Shell , среду командной строки, работающую в облаке.

В Google Cloud Console щелкните значок Cloud Shell на верхней правой панели инструментов:

Подготовка и подключение к среде займет всего несколько минут. Когда все будет готово, вы должны увидеть что-то вроде этого:

Эта виртуальная машина оснащена всеми необходимыми инструментами разработки. Он предлагает постоянный домашний каталог объемом 5 ГБ и работает в Google Cloud, что значительно повышает производительность сети и аутентификацию. Всю работу в этой лаборатории кода можно выполнять в браузере. Вам не нужно ничего устанавливать.

5. Прежде чем начать

Включить API

В Cloud Shell убедитесь, что идентификатор вашего проекта настроен:

gcloud config list project
gcloud config set project [YOUR-PROJECT-ID]
project=[YOUR-PROJECT-ID]
region=[YOUR-REGION]
echo $project
echo $region

Включите все необходимые службы:

gcloud services enable compute.googleapis.com

6. Определите проект Looker PSC

Создание экземпляра Cloud SQL PSC требует идентификации разрешенных проектов psc, поэтому проект клиента Looker PSC должен быть предоставлен во время создания экземпляра Cloud SQL или обновлен при использовании существующего экземпляра.

Определите проект Looker PSC с помощью gcloud

В Cloud Shell обновите [INSTANCE_NAME], указав имя экземпляра Looker PSC, чтобы получить идентификатор проекта Looker PSC:

gcloud looker instances describe [INSTANCE_NAME] --region=$region --format=json | grep -i lookerServiceAttachmentUri

В примере вывода t7ec792caf2a609d1-tp — это проект Looker PSC:

gcloud looker instances describe looker-psc-instance --region=us-central1 --format=json | grep -i lookerServiceAttachmentUri
    "lookerServiceAttachmentUri": "projects/t7ec792caf2a609d1-tp/regions/us-central1/serviceAttachments/looker-psc-f51982e2-ac0d-48b1-91bb-88656971c183",

Определите проект Looker PSC с помощью Cloud Console

В Cloud Console перейдите к:

Looker → Экземпляр Looker PSC

7. Создайте экземпляр Producer Cloud SQL.

В следующем разделе вы создадите экземпляр Cloud SQL PSC, используемый в целях тестирования, развернутый с предопределенным паролем, указывающим проект Looker PSC в списке разрешенных проектов psc.

ПРИМЕЧАНИЕ. Пароль root для экземпляра Cloud SQL PSC предварительно определен как пароль123. Этот экземпляр используется в демонстрационных целях.

Создание Cloud SQL PSC

В Cloud Shell создайте экземпляр и включите Private Service Connect, обновите [INSTANCE_PROJECT], указав свой идентификатор проекта Looker PSC.

gcloud sql instances create cloud-sql-psc-demo \
--project=$project \
--region=$region \
--enable-private-service-connect \
--allowed-psc-projects=[INSTANCE_PROJECT] \
--availability-type=regional \
--no-assign-ip \
--cpu=2 --memory=4GB \
--database-version=MYSQL_8_0 \
--enable-bin-log \
--root-password=password123

Пример:

gcloud sql instances create cloud-sql-psc-demo \
--project=$project \
--region=$region \
--enable-private-service-connect \
--allowed-psc-projects=t7ec792caf2a609d1-tp \
--availability-type=regional \
--no-assign-ip \
--cpu=2 --memory=4GB \
--database-version=MYSQL_8_0 \
--enable-bin-log \
--root-password=password123

Получите вложение службы Cloud SQL.

После создания экземпляра Cloud SQL с включенным Private Service Connect получите URI вложения службы, который будет использоваться на более позднем этапе для создания конечной точки Private Service Connect в Looker.

Внутри Cloud Shell выполните следующие действия:

gcloud sql instances describe [INSTANCE_NAME] --project=$project | grep -i pscServiceAttachmentLink

В результате вывода примера создается URI вложения службы:

проекты/o6222fa10e2a50865p-tp/regions/us-central1/serviceAttachments/a-39d809aaecae-psc-service-attachment-127fc34733744155

gcloud sql instances describe cloud-sql-psc-demo --project=$project | grep -i pscServiceAttachmentLink:
pscServiceAttachmentLink: projects/o6222fa10e2a50865p-tp/regions/us-central1/serviceAttachments/a-39d809aaecae-psc-service-attachment-127fc34733744155

Из Cloud Console вы можете получить вложение службы Cloud SQL PSC:

В Cloud Console перейдите к:

SQL → Экземпляр SQL → Соединения

8. Установите соединение с конечной точкой PSC в Looker.

В следующем разделе вы свяжете вложение службы Cloud SQL Producers с Looker Core PSC с помощью флагов –psc-service-attachment в Cloud Shell для одного домена.

ПРИМЕЧАНИЕ. Каждый раз, когда вы запускаете команду обновления с флагами –psc-service-attachment, вы должны включать все соединения, которые вы хотите включить, включая соединения, которые уже были включены ранее. Пример можно найти в документации Looker PSC.

ПРИМЕЧАНИЕ. Прежде чем продолжить, необходимо включить экземпляр Looker PSC .

В Cloud Shell создайте ассоциацию psc, обновив следующие параметры в соответствии с вашей средой:

• INSTANCE_NAME: имя вашего экземпляра Looker (ядро Google Cloud).
• ДОМЕН_1: sql.database1.com
• SERVICE_ATTACHMENT_1: URI, полученный при описании экземпляра Cloud SQL PSC.
• РЕГИОН: регион, в котором размещен ваш экземпляр Looker (ядро Google Cloud).

Внутри Cloud Shell выполните следующие действия:

gcloud looker instances update INSTANCE_NAME \
--psc-service-attachment  domain=DOMAIN_1,attachment=SERVICE_ATTACHMENT_URI_1 \
--region=REGION

Пример:

gcloud looker instances update looker-psc-instance \
--psc-service-attachment  domain=sql.database1.com,attachment=projects/o6222fa10e2a50865p-tp/regions/us-central1/serviceAttachments/a-39d809aaecae-psc-service-attachment-127fc34733744155 \
--region=us-central1

В Cloud Shell убедитесь, что статус подключения serviceAttachments имеет значение «ACCEPTED». Обязательно обновите Looker PSC INSTANCE_NAME:

gcloud looker instances describe [INSTANCE_NAME] --region=$region --format=json

Пример:

gcloud looker instances describe looker-psc-instance --region=$region --format=json

Пример:

user@cloudshell$ gcloud looker instances describe looker-psc-instance --region=$region --format=json
{
  "adminSettings": {},
  "createTime": "2024-08-23T00:00:45.339063195Z",
  "customDomain": {
    "domain": "looker.cosmopup.com",
    "state": "AVAILABLE"
  },
  "encryptionConfig": {},
  "lookerVersion": "24.14.18",
  "name": "projects/project/locations/us-central1/instances/looker-psc-instance",
  "platformEdition": "LOOKER_CORE_ENTERPRISE_ANNUAL",
  "pscConfig": {
    "allowedVpcs": [
      "projects/project/global/networks/looker-psc-demo",
      "projects/project/global/networks/looker-shared-vpc"
    ],
    "lookerServiceAttachmentUri": "projects/t7ec792caf2a609d1-tp/regions/us-central1/serviceAttachments/looker-psc-f51982e2-ac0d-48b1-91bb-88656971c183",
    "serviceAttachments": [
      {
        "connectionStatus": "ACCEPTED",
        "localFqdn": "sql.database1.com",
        "targetServiceAttachmentUri": "projects/o6222fa10e2a50865p-tp/regions/us-central1/serviceAttachments/a-39d809aaecae-psc-service-attachment-127fc34733744155"
      }
    ]
  },
  "pscEnabled": true,
  "state": "ACTIVE",
  "updateTime": "2024-09-04T14:40:05.613026012Z"
}

Проверьте конечную точку PSC в Cloud Console.

В Cloud Console вы можете проверить соединение PSC.

В Cloud Console перейдите к:

Looker → Экземпляр Looker → Подробности

9. Интегрируйте Looker PSC с Cloud SQL PSC

В следующем разделе вы будете использовать консоль Looker для создания подключения базы данных к экземпляру Cloud SQL PSC.

Перейдите в «АДМИНИСТРАТОР» → «БАЗА ДАННЫХ» → «ПОДКЛЮЧЕНИЯ» → выберите «ДОБАВИТЬ СОЕДИНЕНИЕ».

Заполните данные подключения, как показано на скриншоте ниже, выберите ПОДКЛЮЧИТЬСЯ.

• Убедитесь, что поле HOST в консоли Looker соответствует ранее указанному домену sql.database1.com.
• Для демо-версии требуется имя пользователя «root» и пароль «password123».

Теперь соединение настроено

10. Проверка подключения Looker

В следующем разделе вы узнаете, как проверить подключение Looker к экземпляру Cloud SQL PSC с помощью действия «тест» Looker.

Перейдите в раздел «Админ подключения к данным» → «БАЗА ДАННЫХ» → «СОЕДИНЕНИЯ» → «cloud-sql-psc-demo» → «Тест».

После выбора «Тест» Looker подключится к базе данных postgres, как показано ниже:

Очистить

Удаление компонентов лаборатории из одного терминала Cloud Shell

gcloud sql instances delete cloud-sql-psc-demo -q

11. Поздравления

Поздравляем, вы успешно настроили и проверили подключение к Cloud SQL PSC с помощью консоли Looker на базе Private Service Connect.

Вы создали экземпляры Cloud SQL PSC в качестве конечной точки службы источника и Looker PSC, которая позволяла подключаться к службе источника.

Cosmopup считает, что кодлабы — это здорово!!

Что дальше?

Посмотрите некоторые из этих кодовых лабораторий...

• Использование Private Service Connect для публикации и использования сервисов
• Подключайтесь к локальным службам через гибридную сеть с помощью Private Service Connect и внутреннего балансировщика нагрузки TCP-прокси.
• Доступ ко всем опубликованным лабораториям кода Private Service Connect.

Дальнейшее чтение и видео

• Обзор частного сервиса Connect

Справочная документация

• Подключитесь к экземпляру с помощью Private Service Connect | Облачный SQL для MySQL | Google Облако
• создание экземпляров gcloud sql | Документация Google Cloud CLI
• Создайте экземпляр Looker (ядро Google Cloud) Private Service Connect.
• Как опубликовать службу с помощью Private Service Connect