달빛이 비추는 궁전에서

Gemini CLI와 GCP MCP Server 를 통한 GCP BIgquery 조회

목적 및 배경: gemini Cli와 Google Cloud MCP Server를 연결하여 복잡한 gcloud CLI 명령어 대신, 일상적인 대화(자연어)를 통해 Google Cloud Platform(GCP) 리소스를 생성, 조회, 수정, 삭제하는 시스템을 구축하는 것을 목표로합니다. 2025년 7월 1일 기준으로 Google Cloud MCP Server 는 Google Cloud의 공식 제품은 없습니다. 각MCP 서버별로 제약 사항이 다른 상태입니다. 본 문서에서는 기본적인 구축 후 자연어를 이용하여 Bigquery 조회, 분석하는 방안을 작성하였습니다. 또한 해당 MCP는 현재까지 아래와 같은 제약이 있습니다. Analyze data within safe limits (1GB query limit..

목적 및 배경: gemini Cli와 Google Cloud MCP Server를 연결하여 복잡한 gcloud CLI 명령어 대신, 일상적인 대화(자연어)를 통해 Google Cloud Platform(GCP) 리소스를 생성, 조회, 수정, 삭제하는 시스템을 구축하는 것을 목표로합니다.2025년 7월 1일 기준으로 Google Cloud MCP Server 는 Google Cloud의 공식 제품은 없습니다.각 MCP 서버별로 제약 사항이 다른 상태입니다.본 문서에서는 기본적인 구축 후 자연어를 이용하여 Cloud Logging을 조회, 분석하는 방안을 작성하였습니다. PC 설정Node.js 설치가 필요합니다.아래 공식 사이트에 각 운영체제별 설치법이 가이드 되어 있으니 참고하여 설치합니다.https://..

배경 및 목표Cloud Run은 서버리스 컨테이너를 실행하기 위한 강력한 플랫폼이지만, 기본적으로 서비스 URL은 인터넷에 공개됩니다.보안이 중요한 백엔드 API나 내부 시스템 간의 통신을 위해서는 서비스를 외부 인터넷으로부터 격리하고, 승인된 내부 네트워크에서만 안전하게 호출할 수 있는 아키텍처가 필수적입니다.본 문서는 Private Service Connect(PSC)와 내부 애플리케이션 부하 분산기(Internal ALB)를 조합하여, 공개 인터넷에 노출되지 않는 비공개 Cloud Run 서비스를 구축하는 과정을 다룹니다.사용하는 Gemini API는 빠르게 최신기술을 적용할 수 있는 Public AI인 Google AI Studio 의 Gemini API를 이용합니다.다음편에서는 동일한 SDK로 ..

배경 및 목표Cloud Run은 서버리스 컨테이너를 실행하기 위한 강력한 플랫폼이지만, 기본적으로 서비스 URL은 인터넷에 공개됩니다.보안이 중요한 백엔드 API나 내부 시스템 간의 통신을 위해서는 서비스를 외부 인터넷으로부터 격리하고, 승인된 내부 네트워크에서만 안전하게 호출할 수 있는 아키텍처가 필수적입니다.본 문서는 Private Service Connect(PSC)와 내부 애플리케이션 부하 분산기(Internal ALB)를 조합하여, 공개 인터넷에 노출되지 않는 비공개 Cloud Run 서비스를 구축하는 과정을 다룹니다.사용하는 Gemini API는 빠르게 최신기술을 적용할 수 있는 Public AI인 Google AI Studio 의 Gemini API를 이용합니다.다음편에서는 동일한 SDK로 ..

GCP GCE에서 Serverless 서비스인 Cloud Run (또는 Cloud Functions)을 호출하는 방안에 대해 기술합니다. Cloud Run은 자동 스케일링, 관리 편의성 등의 장점이 있어, 유연하고 확장성 있는 서비스를 제공하는 목적에 적합한 선택입니다. 지난번 테스트에서는 GCE 인스턴스에서 Cloud Run(Function)을 호출하는 과정을 검증하였습니다. 순서는 아래와 같습니다. 1. GCE 인스턴스에서 GCP Metadata 서버를 통해 ID 토큰을 요청하여 인증 정보를 획득합니다. 2. 획득한 인증 토큰을 사용하여 Cloud Run(Function)을 호출합니다. 3. Function 내에서 GCE의 hostname을 수신 및 확인하고, 응답을 GCE로 반환합니다. 4. Clo..

GCP GCE에서 Serverless 서비스인 Cloud Run (또는 Cloud Functions)을 호출하는 방안에 대해 기술합니다.Cloud Run은 자동 스케일링, 관리 편의성 등의 장점이 있어, 유연하고 확장성 있는 서비스를 제공하는 목적에 적합한 선택입니다.이번 테스트에서는 GCE 인스턴스에서 Cloud Run(Function)을 호출하는 과정을 검증합니다.1. GCE 인스턴스에서 GCP Metadata 서버를 통해 ID 토큰을 요청하여 인증 정보를 획득합니다.2. 획득한 인증 토큰을 사용하여 Cloud Run(Function)을 호출합니다.3. Function 내에서 GCE의 hostname을 수신 및 확인하고, 응답을 GCE로 반환합니다.4. Cloud Logging을 통해 실행 여부 및 ..

GCP Compute Engine(GCE)는 VM의 현 상태를 저장 후 복원할 수 있는 스냅샷(snapshot)기능을 제공합니다.스냅샷은 영구 디스크의 백업입니다.스냅샷의 주요 용도는 운영 중인 VM을 특정 스냅샷 시점으로 복구할 수 있습니다.스냅샷을 사용하여 신규 디스크를 만들고, 이를 바탕으로 새로운 VM(GCE) 인스턴스를 생성할 수 있습니다.데이터 복구, 데이터 전송, 또는 프로젝트의 다른 리소스에서 데이터에 접근하는 데 사용됩니다.GCP에서는 GUI(콘솔)를 통해 클릭 몇 번으로 이 작업을 수행할 수 있습니다.CLI(gcloud+shell script)로도 동일한 설정이 가능합니다.특히 대량의 작업을 수행해야 할 경우, CLI 방식이 훨씬 유리합니다. 이 글에서는 두 가지 방식을 모두 상세히 다..

Cloud SQL은 GCP에서 제공하는 관리형 DBMS로 사용자는 DB를 잘 사용하는것에 집중하고, 관리는 GCP가 해주는 부분입니다. 백업도 알아서 시간대만 지정해 주면, 하루에 한번 해당 시간대에 백업을 해줍니다. 그 외에는 사용자가 콘솔(GUI)에서 직접 수동 백업을 실행하거나, gcloud 명령어로 수동 백업을 받을 수 있습니다.하지만 운영을 하다보면 여러 작업과 사정이 있고, 예를 들어 6시간 간격으로 백업이 필요한 경우도 있을 수 있을 것입니다. 이러한 상황을 가정하고, 파이썬 코드+Cloud Run(Function)+Cloud Scheduler 을 통해 일회성 백업과 지정된 시간에 백업을 하는 방안에 대해 작성하였습니다. 구성도필요권한 : Cloud SQL 백업을 트리거하려면 최소 cloud..

GCP Cloud SQL은 GUI를 통해 간편하게 백업을 생성하고 동일 인스턴스로 복원하는 기능을 제공합니다. 하지만 백업을 다른 새 인스턴스나 다른 프로젝트의 인스턴스로 복원해야 할 경우, GUI에서는 직접적인 지원이 없습니다. GUI에서 지원하지 않는 기능이 CLI에서 지원되는 경우가 있습니다. Cloud SQL의 내장 백업은 파일 형태로 직접 내보내기(Export)를 지원하지 않으며, 데이터를 파일로 옮기려면 mysqldump와 같은 별도의 내보내기 작업을 통해 Cloud Storage 버킷 등에 저장한 후 다시 가져오기(Import) 해야 합니다. 이와 달리, gcloud CLI를 사용하면 Cloud SQL 백업에서 바로 다른 인스턴스(신규 또는 타 프로젝트)로 복원할 수 있습니다. 이는 mysq..

클라우드의 장점 중에 하나는 GUI에서 클릭으로 할 수 있는 방안이라고 생각됩니다. CLI로 대량의 작업을 한번에 할 수 있는 방안도 있지만간단하게 필요할때 화면에 나오는 설명을 따라서 설정해서 할 수 있다는 것은 크나큰 장점이라 생각됩니다. 다만 위에 쓴대로 대량의 작업을 한번에 하는건 GUI로는 힘듭니다. 이번 스크립트는 GCP의 Secret Manager 서비스에 있는 리소스들을 프로젝트 단위에서 삭제하는 방안을 작성하였습니다. 해당 삭제 스크립트를 만들게 된 계기는 다음과 같습니다. GCP에서 프로젝트가 필요없게 되면 정리를 해야되는데 결제계정을 빼면 모든 리소스가 정지되게 되며, 아예 프로젝트를 삭제하는 방안도 있습니다. 다만 여러 이유로 프로젝트가 존재할 필요가 있을때는 비용이 발생되는 리소..