1. 소개
최종 업데이트: 2024년 11월 1일
오래된 PHP 애플리케이션을 Google Cloud로 현대화하려면 어떻게 해야 하나요?
(📽️ 이 Codelab에 관한 7분 분량의 소개 동영상 시청)
온프레미스에서 실행되는 레거시 애플리케이션을 현대화해야 하는 경우가 많습니다. 즉, 확장 가능하고 안전하며 다양한 환경에 배포할 수 있도록 만들어야 합니다.
이 워크숍에서 학습할 내용은 다음과 같습니다.
- PHP 애플리케이션을 컨테이너화합니다.
- 관리형 데이터베이스 서비스(Cloud SQL)로 이전합니다.
- Cloud Run에 배포합니다(GKE/Kubernetes의 제로 운영 대안).
- Identity and Access Management(IAM) 및 Secret Manager를 사용하여 애플리케이션을 보호합니다.
- Cloud Build를 통해 CI/CD 파이프라인을 정의합니다. Cloud Build는 GitHub 또는 GitLab과 같은 인기 있는 Git 제공업체에서 호스팅하는 Git 저장소와 연결할 수 있으며, 예를 들어 기본 브랜치에 푸시가 발생할 때마다 트리거될 수 있습니다.
- Cloud Storage에서 애플리케이션 사진을 호스팅합니다. 이는 마운트를 통해 이루어지며 앱을 변경하는 데 코드가 필요하지 않습니다.
- Cloud Functions(서버리스)를 통해 조정되는 Gemini를 통해 생성형 AI 기능을 도입합니다.
- SLO 및 새로 업데이트된 앱 운영에 익숙해집니다.
이 단계를 따르면 PHP 애플리케이션을 점진적으로 현대화하여 확장성, 보안, 배포 유연성을 개선할 수 있습니다. 또한 Google Cloud로 이전하면 강력한 인프라와 서비스를 활용하여 클라우드 네이티브 환경에서 애플리케이션을 원활하게 실행할 수 있습니다.
이 간단한 단계를 통해 배운 내용은 다양한 언어/스택과 다양한 사용 사례를 사용하는 자체 애플리케이션 및 조직에 적용할 수 있습니다.
앱 정보
포크할 애플리케이션(MIT 라이선스에 따른 코드)은 MySQL 인증을 사용하는 기본 PHP 5.7 애플리케이션입니다. 이 앱의 주요 아이디어는 사용자가 사진을 업로드할 수 있는 플랫폼을 제공하고 관리자가 부적절한 이미지에 태그를 지정할 수 있도록 하는 것입니다. 애플리케이션에는 두 개의 테이블이 있습니다.
- 사용자 관리자와 함께 사전 컴파일되어 제공됩니다. 새로운 사용자가 등록할 수 있습니다.
- Images에 저장 몇 가지 샘플 이미지가 함께 제공됩니다. 로그인한 사용자는 새 사진을 업로드할 수 있습니다. 여기에 약간의 마법을 더해 보겠습니다.
목표
Google Cloud에서 사용할 수 있도록 기존 애플리케이션을 현대화하려고 합니다. Google Cloud의 도구와 서비스를 활용하여 확장성을 개선하고, 보안을 강화하고, 인프라 관리를 자동화하고, Cloud SQL, Cloud Run, Cloud Build, Secret Manager 등의 서비스를 사용하여 이미지 처리, 모니터링, 데이터 스토리지와 같은 고급 기능을 통합할 것입니다.

무엇보다도, 각 단계의 이면에 있는 사고 과정을 학습할 수 있도록 단계별로 진행하고자 합니다. 일반적으로 각 단계는 다음 단계의 새로운 가능성을 열어줍니다(예: 모듈 2 -> 3, 6 -> 7).
아직 망설여지시나요? YouTube에서 이 7분 길이의 동영상을 확인하세요.
필요한 항목
- 브라우저가 있고 인터넷에 연결된 컴퓨터
- 일부 GCP 크레딧 다음 단계를 참고하세요.
- Cloud Shell을 사용합니다. 필요한 모든 사전 설치된 명령어와 IDE가 함께 제공됩니다.
- GitHub 계정 원본 코드 🧑🏻💻 gdgpescara/app-mod-workshop을 자체 Git 저장소로 브랜치하려면 이 토큰이 필요합니다. 자체 CI/CD 파이프라인(자동 커밋 -> 빌드 -> 배포)을 보유하는 데 필요합니다.
샘플 솔루션은 여기에서 확인할 수 있습니다.
- 작성자 저장소: https://github.com/Friends-of-Ricc/app-mod-workshop
- 원본 워크숍 저장소:
.solutions/폴더 아래에 챕터별로 있습니다.
이 워크숍은 브라우저의 Cloud Shell에서 완료하도록 설계되었습니다.
하지만 로컬 컴퓨터에서 시도할 수도 있습니다.
2. 크레딧 설정 및 포크

GCP 크레딧 사용 및 GCP 환경 설정[선택사항]
이 워크숍을 실행하려면 크레딧이 있는 결제 계정이 필요합니다. 이 Codelab 상단의 배너에 있는 크레딧을 사용하여 시작합니다. 이미 결제 계정에 연결되어 있으면 이 단계를 건너뛸 수 있습니다.
완료되면 Google Cloud 콘솔을 열고 '조직 없음'이 표시된 왼쪽 상단 드롭다운 메뉴에서 프로젝트 선택기를 클릭하여 새 프로젝트를 만듭니다. 아래 참조

아래 스크린샷과 같이 프로젝트가 없는 경우 새 프로젝트를 만듭니다. 오른쪽 상단에 '새 프로젝트' 옵션이 있습니다.

다음과 같이 새 프로젝트를 GCP 무료 체험 결제 계정에 연결해야 합니다.

Google Cloud Platform을 사용할 준비가 되었습니다. 초보자이거나 클라우드 환경에서 모든 작업을 수행하려는 경우 아래와 같이 왼쪽 상단의 다음 버튼을 통해 Cloud Shell 및 편집기에 액세스할 수 있습니다.

왼쪽 상단에서 새 프로젝트가 선택되어 있는지 확인합니다.
선택되지 않음(나쁨):

선택됨(양호):

GitHub에서 앱 포크
- 데모 앱(https://github.com/gdgpescara/app-mod-workshop)으로 이동합니다.
- 포크를 클릭하세요 🍴.
- GitHub 계정이 없는 경우 새 계정을 만들어야 합니다.
- 원하는 대로 수정합니다.

- 다음 명령어를 사용하여 앱 코드를 클론합니다.
git clonehttps://github.com/YOUR-GITHUB-USER/YOUR-REPO-NAME
- 원하는 편집기로 클론된 프로젝트 폴더를 엽니다. Cloud Shell을 선택하는 경우 아래와 같이 '편집기 열기'를 클릭하면 됩니다.

다음 그림과 같이 Google Cloud Shell 편집기에는 필요한 모든 것이 있습니다.

이는 '폴더 열기'를 클릭하고 홈 폴더에서 app-mod-workshop 폴더를 선택하여 시각적으로 수행할 수 있습니다.
3. 모듈 1: SQL 인스턴스 만들기
Google Cloud SQL 인스턴스 만들기
PHP 앱이 MySQL 데이터베이스에 연결되므로 원활한 마이그레이션을 위해 Google Cloud에 복제해야 합니다. Cloud SQL은 클라우드에서 완전 관리형 MySQL 데이터베이스를 실행할 수 있으므로 완벽한 선택입니다. 다음 단계를 따르세요.
- Cloud SQL 페이지(https://console.cloud.google.com/sql/instances)로 이동합니다.
- "인스턴스 생성"을 클릭하세요.
- API를 사용 설정합니다(필요한 경우). 이 작업은 몇 초 정도 걸릴 수 있습니다.
- MySQL을 선택합니다.
- (가장 저렴한 버전을 제공하여 더 오래 사용할 수 있도록 노력하고 있습니다.)
- 버전: Enterprise
- 사전 설정: 개발(샌드박스를 사용해 보았지만 효과가 없었음)
- MySQL 버전: 5.7(오래된 버전이네요)
- 인스턴스 ID:
appmod-phpapp를 선택합니다. 이를 변경하는 경우 향후 스크립트와 솔루션도 그에 따라 변경해야 합니다. - 비밀번호: 원하는 비밀번호를 입력하되 CLOUDSQL_INSTANCE_PASSWORD로 기록해 둡니다.
- 리전: 앱의 나머지 부분에 선택한 것과 동일하게 유지합니다(예: 밀라노 =
europe-west8). - 영역 가용성: 단일 영역(데모용으로 비용 절감)
'인스턴스 만들기' 버튼을 클릭하여 Cloud SQL 데이터베이스를 배포합니다. ⌛ 완료하는 데 약 10분이 걸립니다.⌛ 그동안 문서를 계속 읽으세요. 다음 모듈('PHP 앱 컨테이너화')은 첫 번째 부분에서 이 모듈에 종속되지 않으므로(DB 연결을 수정할 때까지) 다음 모듈을 해결하기 시작할 수도 있습니다.
참고: 이 인스턴스의 비용은 하루에 약 7달러입니다. 워크숍이 끝난 후에는 반드시 분리하세요.
Cloud SQL에서 image_catalog DB 및 사용자 만들기
앱 프로젝트에는 두 개의 sql 파일이 포함된 db/ 폴더가 있습니다.
- 01_schema.sql: 사용자 및 이미지 데이터가 포함된 두 개의 테이블을 만드는 SQL 코드가 포함되어 있습니다.
- 02_seed.sql: 이전에 만든 테이블에 데이터를 시드하는 SQL 코드가 포함되어 있습니다.
이러한 파일은 나중에 image_catalog 데이터베이스가 생성되면 사용됩니다. 이렇게 하려면 다음 단계를 따르세요.
- 인스턴스를 열고 데이터베이스 탭을 클릭합니다.
- '데이터베이스 만들기'를 클릭합니다.
- 이름을
image_catalog로 지정합니다(PHP 앱 구성과 동일).

그런 다음 데이터베이스 사용자를 만듭니다. 이를 통해 image_catalog 데이터베이스에 인증할 수 있습니다.
- 이제 사용자 탭을 클릭합니다.
- '사용자 계정 추가'를 클릭합니다.
- 사용자: 하나 만들어 보자.
- 사용자 이름:
appmod-phpapp-user - 비밀번호: 기억할 수 있는 비밀번호를 선택하거나 '생성'을 클릭합니다.
- '모든 호스트 허용(%)'을 유지합니다.
- '추가'를 클릭합니다.
잘 알려진 IP에 DB를 엽니다.
Cloud SQL의 모든 DB는 '격리'된 상태로 생성됩니다. 액세스할 수 있는 네트워크를 명시적으로 설정해야 합니다.
- 인스턴스를 클릭합니다.
- '연결' 메뉴를 엽니다.
- '네트워킹' 탭을 클릭합니다.
- '승인된 네트워크' 아래를 클릭합니다. 이제 네트워크(즉, 서브넷)를 추가합니다.
- 지금은 앱이 작동하도록 빠르지만 안전하지 않은 설정을 선택하겠습니다. 나중에 신뢰할 수 있는 IP로 제한할 수 있습니다.
- 이름: '전 세계 모든 사용자 - 안전하지 않음'
- 네트워크: "
0.0.0.0/0"(참고: 이 부분은 안전하지 않습니다!) - '완료' 클릭
- 저장을 클릭합니다.
다음과 같은 결과를 확인할 수 있습니다.

참고: 이 솔루션은 몇 시간 내에 워크숍을 완료하기에 적합한 절충안입니다. 하지만 SECURITY 문서를 확인하여 프로덕션 솔루션을 보호하세요.
DB 연결을 테스트할 차례입니다.
이전에 만든 image_catalog 사용자가 작동하는지 확인해 보겠습니다.
인스턴스 내에서 'Cloud SQL Studio'에 액세스하고 아래와 같이 인증할 데이터베이스, 사용자, 비밀번호를 입력합니다.

이제 SQL 편집기를 열고 다음 섹션으로 진행할 수 있습니다.
코드베이스에서 데이터베이스 가져오기
SQL 편집기를 사용하여 image_catalog 테이블을 데이터와 함께 가져옵니다. 저장소의 파일(01_schema.sql, 02_seed.sql)에서 SQL 코드를 복사하고 순서대로 하나씩 실행합니다.
그러면 아래와 같이 image_catalog에 users 및 images라는 두 개의 테이블이 생성됩니다.

편집기에서 select * from images;을 실행하여 테스트할 수 있습니다.
또한 나중에 필요하므로 Cloud SQL 인스턴스의 공개 IP 주소를 기록해 둡니다. IP를 가져오려면 개요 페이지에서 Cloud SQL 인스턴스 기본 페이지로 이동합니다. (개요 > 이 인스턴스에 연결 > 공개 IP 주소)
4. 모듈 2: PHP 앱 컨테이너화

이 앱을 클라우드용으로 빌드하려고 합니다.
즉, 클라우드에서 코드를 실행하는 데 필요한 모든 정보가 포함된 ZIP 파일로 코드를 패키징합니다.
패키징하는 방법에는 몇 가지가 있습니다.
- Docker 매우 인기가 있지만 올바르게 설정하기가 상당히 복잡합니다.
- 빌드팩 인기가 적지만 빌드할 항목과 실행할 항목을 '자동 추측'하는 경향이 있습니다. 대부분의 경우 정상적으로 작동합니다.
이 워크숍에서는 Docker를 사용한다고 가정합니다.
Cloud Shell을 사용하기로 선택한 경우 지금 다시 열어야 합니다(Cloud 콘솔 오른쪽 상단 클릭).

그러면 페이지 하단에 편리한 셸이 열리며, 여기에서 설정 단계에서 코드를 포크해야 합니다.

Docker
제어 권한을 갖고 싶다면 이 솔루션이 적합합니다. 이는 특정 라이브러리를 구성하고 명확하지 않은 특정 동작(업로드 시 chmod, 앱의 비표준 실행 파일 등)을 삽입해야 할 때 유용합니다.
컨테이너화된 애플리케이션을 Cloud Run에 배포하는 것이 최종 목표이므로 다음 문서를 확인하세요. PHP 8에서 PHP 5.7로 백포트하려면 어떻게 해야 하나요? Gemini를 사용해 보세요. 또는 다음과 같이 사전 빌드된 버전을 사용할 수 있습니다.
# Use the official PHP image: https://hub.docker.com/_/php
FROM php:5.6-apache
# Configure PHP for Cloud Run.
# Precompile PHP code with opcache.
# Install PHP's extension for MySQL
RUN docker-php-ext-install -j "$(nproc)" opcache mysqli pdo pdo_mysql && docker-php-ext-enable pdo_mysql
RUN set -ex; \
{ \
echo "; Cloud Run enforces memory & timeouts"; \
echo "memory_limit = -1"; \
echo "max_execution_time = 0"; \
echo "; File upload at Cloud Run network limit"; \
echo "upload_max_filesize = 32M"; \
echo "post_max_size = 32M"; \
echo "; Configure Opcache for Containers"; \
echo "opcache.enable = On"; \
echo "opcache.validate_timestamps = Off"; \
echo "; Configure Opcache Memory (Application-specific)"; \
echo "opcache.memory_consumption = 32"; \
} > "$PHP_INI_DIR/conf.d/cloud-run.ini"
# Copy in custom code from the host machine.
WORKDIR /var/www/html
COPY . .
# Setup the PORT environment variable in Apache configuration files: https://cloud.google.com/run/docs/reference/container-contract#port
ENV PORT=8080
# Tell Apache to use 8080 instead of 80.
RUN sed -i 's/80/${PORT}/g' /etc/apache2/sites-available/000-default.conf /etc/apache2/ports.conf
# Note: This is quite insecure and opens security breaches. See last chapter for hardening ideas.
# Uncomment at your own risk:
#RUN chmod 777 /var/www/html/uploads/
# Configure PHP for development.
# Switch to the production php.ini for production operations.
# RUN mv "$PHP_INI_DIR/php.ini-production" "$PHP_INI_DIR/php.ini"
# https://github.com/docker-library/docs/blob/master/php/README.md#configuration
RUN mv "$PHP_INI_DIR/php.ini-development" "$PHP_INI_DIR/php.ini"
# Expose the port
EXPOSE 8080
최신 Dockerfile 버전은 여기에서 확인할 수 있습니다.
애플리케이션을 로컬에서 테스트하려면 PHP 앱이 Google Cloud SQL에서 사용할 수 있는 MYSQL DB에 연결되도록 config.php 파일을 변경해야 합니다. 이전에 설정한 내용을 바탕으로 빈칸을 채우세요.
<?php
// Database configuration
$db_host = '____________';
$db_name = '____________';
$db_user = '____________';
$db_pass = '____________';
try {
$pdo = new PDO("mysql:host=$db_host;dbname=$db_name", $db_user, $db_pass);
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
} catch (PDOException $e) {
die("Errore di connessione: " . $e->getMessage());
}
session_start();
?>
DB_HOST는 Cloud SQL 공개 IP 주소이며 SQL 콘솔에서 찾을 수 있습니다.

DB_NAME는 변경되지 않아야 합니다.image_catalogDB_USER은(는)appmod-phpapp-user이어야 합니다.DB_PASS은(는) 내가 선택한 것입니다. 작은따옴표로 설정하고 필요에 따라 이스케이프 처리합니다.
또한 Gemini를 사용하여 🇮🇹 이탈리아어 콘텐츠를 영어로 번역해 보세요.
이제 Dockerfile가 있고 DB에 연결하도록 PHP 앱을 구성했으므로 사용해 보겠습니다.
Docker가 아직 설치되어 있지 않으면 설치합니다(링크). Cloud Shell을 사용하는 경우에는 이 작업이 필요하지 않습니다.
이제 적절한 Docker 빌드 및 실행 명령어를 사용하여 컨테이너화된 PHP 앱을 빌드하고 실행해 보세요.
# Build command - don't forget the final . This works if Dockerfile is inside the code folder:
$ docker build -t my-php-app-docker .
# Local Run command: most likely ports will be 8080:8080
$ docker run -it -p <CONTAINER_PORT>:<LOCAL_MACHINE_PORT> my-php-app-docker
모든 것이 작동하면 로컬 호스트에 연결할 때 다음 웹페이지가 표시됩니다. 이제 앱이 포트 8080에서 실행됩니다. '웹 미리보기' 아이콘(눈 모양이 있는 브라우저)을 클릭한 다음 포트 8080에서 미리보기를 클릭합니다(다른 포트의 경우 '포트 변경').

브라우저에서 결과 테스트하기
이제 애플리케이션이 다음과 같이 표시됩니다.

Admin/admin123으로 로그인하면 다음과 같은 화면이 표시됩니다.

좋습니다. 이탈리아어 텍스트를 제외하고는 잘 작동합니다. 🎉🎉🎉
도커화는 잘 되었지만 DB 사용자 인증 정보가 잘못된 경우 다음과 같은 결과가 표시될 수 있습니다.

다시 시도해 보세요. 거의 다 왔습니다.
Artifact Registry에 저장[선택사항]
이제 클라우드에 배포할 준비가 된 컨테이너화된 PHP 애플리케이션이 작동해야 합니다. 다음으로, Docker 이미지를 저장하고 Cloud Run과 같은 Google Cloud 서비스에 배포할 수 있도록 클라우드에 저장할 공간이 필요합니다. 이 스토리지 솔루션은 Artifact Registry라고 하며, Docker 컨테이너 이미지, Maven 패키지, npm 모듈 등 애플리케이션 아티팩트를 저장하도록 설계된 완전 관리형 Google Cloud 서비스입니다.
적절한 버튼을 사용하여 Google Cloud Artifact Registry에 저장소를 만들어 보겠습니다.

유효한 이름, 아티팩트를 저장하는 데 적합한 형식 및 리전을 선택합니다.

로컬 개발 환경으로 돌아가서 방금 만든 Artifact Registry 저장소에 앱 컨테이너 이미지를 태그하고 푸시합니다. 다음 명령어를 완료하여 이 작업을 수행합니다.
- docker tag SOURCE_IMAGE[:TAG] TARGET_IMAGE[:TAG]
- docker push TARGET_IMAGE[:TAG]
다음 스크린샷과 같은 결과가 표시됩니다.

축하합니다 🎉🎉🎉 다음 단계로 이동할 수 있습니다. 그 전에 2분 정도 시간을 내어 업로드/로그인/로그아웃을 시도하고 앱 엔드포인트에 익숙해지세요.나중에 필요할 것입니다.
발생 가능한 오류
컨테이너화 오류가 발생하면 Gemini를 사용하여 오류를 설명하고 수정해 보세요. 다음을 제공합니다.
- 현재 Dockerfile
- 수신된 오류
- [필요한 경우] 실행 중인 PHP 코드
업로드 권한 /upload.php 엔드포인트를 사용해 보고 사진을 업로드해 보세요. 아래와 같은 오류가 발생할 수 있습니다. 그렇다면 Dockerfile에서 chmod/chown를 수정해야 합니다.
경고: move_uploaded_file(uploads/image (3).png): failed to open stream: Permission denied in /var/www/html/upload.php on line 11
PDOException "could not find driver"(또는 "Errore di connessione: could not find driver"). Dockerfile에 DB에 연결하기 위한 적절한 mysql용 PDO 라이브러리(pdo_mysql)가 있는지 확인합니다. 여기에서 솔루션에 대한 아이디어를 얻으세요.
요청을 백엔드로 전달할 수 없습니다. 포트 8080의 서버에 연결할 수 없습니다. 이는 잘못된 포트를 노출하고 있음을 의미합니다. Apache/Nginx가 실제로 제공하는 포트를 노출하고 있는지 확인합니다. 이는 간단한 문제가 아닙니다. 가능하면 포트 8080을 사용하세요(Cloud Run을 사용하면 더 편리함). 포트 80을 유지하려면(예: Apache에서 원하는 경우) 다른 명령어를 사용하여 실행합니다.
$ docker run -it -p 8080:80 # force 80
# Use the PORT environment variable in Apache configuration files.
# https://cloud.google.com/run/docs/reference/container-contract#port
RUN sed -i 's/80/${PORT}/g' /etc/apache2/sites-available/000-default.conf /etc/apache2/ports.conf
5. 모듈 3: Cloud Run에 앱 배포

Cloud Run을 선택해야 하는 이유
좋은 질문입니다. 몇 년 전이라면 Google App Engine을 선택했을 것입니다.
간단히 말해, 오늘날 Cloud Run은 더 새로운 기술 스택을 갖추고 있으며, 배포가 더 쉽고, 저렴하며, 사용하지 않을 때는 0으로 축소됩니다. 스테이트리스(Stateless) 컨테이너를 실행할 수 있는 유연성과 다양한 Google Cloud 서비스와의 통합을 통해 최소한의 오버헤드와 최대의 효율성으로 마이크로서비스와 최신 애플리케이션을 배포하는 데 이상적입니다.
더 구체적으로 말하자면 Cloud Run은 서버리스 환경에서 스테이트리스(Stateless) 컨테이너화된 애플리케이션을 실행할 수 있는 Google Cloud의 완전 관리형 플랫폼입니다. 모든 인프라를 자동으로 처리하며, 수신 트래픽에 맞게 0에서 확장하고 유휴 상태일 때는 축소하므로 비용 효율적이고 효율적입니다. Cloud Run은 컨테이너에 패키징되어 있는 한 모든 언어 또는 라이브러리를 지원하므로 개발에 뛰어난 유연성을 제공합니다. 다른 Google Cloud 서비스와 잘 통합되며 서버 인프라를 관리할 필요 없이 마이크로서비스, API, 웹사이트, 이벤트 기반 애플리케이션을 빌드하는 데 적합합니다.
기본 요건
이 작업을 완료하려면 로컬 머신에 gcloud가 설치되어 있어야 합니다. 그렇지 않은 경우 여기에서 안내를 참고하세요. Google Cloud Shell을 사용하는 경우에는 별도의 조치를 취하지 않아도 됩니다.
배포하기 전에
로컬 환경에서 작업하는 경우 다음을 사용하여 Google Cloud에 인증합니다.
$ gcloud auth login –update-adc # not needed in Cloud Shell
이렇게 하면 브라우저에서 OAuth 로그인을 통해 인증됩니다. 결제가 사용 설정된 Google Cloud에 로그인한 사용자와 동일한 사용자(예: vattelapesca@gmail.com)로 Chrome을 통해 로그인해야 합니다.
다음 명령어를 사용하여 Cloud Run API를 사용 설정합니다.
$ gcloud services enable run.googleapis.com cloudbuild.googleapis.com
이제 Cloud Run에 배포할 준비가 모두 완료되었습니다.
gcloud를 통해 Cloud Run에 앱 배포
Cloud Run에 앱을 배포할 수 있는 명령어는 gcloud run deploy입니다. 목표를 달성하기 위해 설정할 수 있는 몇 가지 옵션이 있습니다. 최소 옵션 집합(명령줄을 통해 제공하거나 도구에서 대화형 프롬프트로 요청)은 다음과 같습니다.
- 앱에 배포하려는 Cloud Run 서비스의 이름입니다. Cloud Run 서비스는 앱의 엔드포인트를 제공하는 URL을 반환합니다.
- 앱이 실행될 Google Cloud 리전입니다. (
--region리전) - 앱을 래핑하는 컨테이너 이미지
- 앱이 실행 중에 사용해야 하는 환경 변수입니다.
- 추가 인증 없이 누구나 앱에 액세스할 수 있도록 허용하는 Allow-Unauthenticated 플래그
문서를 참고하거나 아래로 스크롤하여 가능한 해결 방법을 확인하여 이 옵션을 명령줄에 적용하는 방법을 알아보세요.
배포하는 데 몇 분 정도 걸립니다. 모든 항목이 올바르면 Google Cloud 콘솔에 다음과 같이 표시됩니다.


Cloud Run에서 제공하는 URL을 클릭하고 애플리케이션을 테스트합니다. 인증되면 다음과 같이 표시됩니다.

인수가 없는 'gcloud run deploy'
gcloud run deploy가 적절한 질문을 하고 빈칸을 채우는 것을 보셨을 것입니다. 정말 멋져요.
하지만 몇 가지 모듈에서 이 명령어를 Cloud Build 트리거에 추가할 예정이므로 대화형 질문을 사용할 수 없습니다. 명령어의 모든 옵션을 채워야 합니다. 따라서 완벽한 gcloud run deploy --option1 blah --foo bar --region your-fav-region를 만들어야 합니다. 어떻게 하시나요?
- gcloud에서 질문을 중지할 때까지 2~3~4단계를 반복합니다.
- [LOOP] 지금까지 찾은 옵션이 있는
gcloud run deploy - [LOOP] 시스템에서 X 옵션 요청
- [LOOP] 공개 문서에서
--my-option [my-value]옵션을 추가하여 CLI에서 X를 설정하는 방법을 검색합니다. - gcloud가 추가 질문 없이 완료되지 않는 한 이제 2단계로 돌아갑니다.
- gcloud run deploy BLAH BLAH BLAH는 정말 멋집니다. 나중에 Cloud Build 단계에서 필요하므로 명령어를 어딘가에 저장해 두세요.
가능한 해결 방법은 여기에서 확인할 수 있습니다. 문서는 여기에 있습니다.
축하합니다. 🎉🎉🎉 Google Cloud에 앱을 배포하여 현대화의 첫 단계를 완료했습니다.
6. 모듈 4: Secret Manager를 사용한 비밀번호 정리

이전 단계에서는 Cloud Run에서 앱을 성공적으로 배포하고 실행할 수 있었습니다. 하지만 일부 보안 비밀을 일반 텍스트로 제공하는 보안 권장사항을 따르지 않았습니다.
첫 번째 반복: ENV를 사용하도록 config.php 업데이트
config.php 파일의 코드에 DB 비밀번호를 바로 입력했다는 사실을 눈치채셨을 것입니다. 테스트 목적으로 앱이 작동하는지 확인하는 데는 문제가 없습니다. 하지만 프로덕션 환경에서는 이러한 코드를 커밋하거나 사용할 수 없습니다. 비밀번호(및 기타 DB 연결 매개변수)는 동적으로 읽고 런타임에 앱에 제공해야 합니다. ENV 변수에서 db 매개변수를 읽도록 config.php 파일을 변경합니다. 실패하면 기본값 설정을 고려해야 합니다. 이렇게 하면 ENV를 로드하지 못하는 경우 페이지 출력에서 기본값을 사용하고 있는지 알려줍니다. 빈칸을 채우고 config.php의 코드를 바꿉니다.
<?php
// Database configuration with ENV variables. Set default values as well
$db_host = getenv('DB_HOST') ?: 'localhost';
$db_name = getenv('DB_NAME') ?: 'image_catalog';
$db_user = getenv('DB_USER') ?: 'appmod-phpapp-user';
$db_pass = getenv('DB_PASS') ?: 'wrong_password';
// Note getenv() is PHP 5.3 compatible
try {
$pdo = new PDO("mysql:host=$db_host;dbname=$db_name", $db_user, $db_pass);
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
} catch (PDOException $e) {
die("Errore di connessione: " . $e->getMessage());
}
session_start();
?>
앱이 컨테이너화되어 있으므로 앱에 ENV 변수를 제공하는 방법을 제공해야 합니다. 이 작업은 다음과 같은 몇 가지 방법으로 수행할 수 있습니다.
- 빌드 시 Dockerfile에서 ENV DB_VAR=ENV_VAR_VALUE 문법을 사용하여 이전 Dockerfile에 4개의 매개변수를 추가합니다. 이렇게 하면 런타임 시 재정의할 수 있는 기본값이 설정됩니다. 예를 들어 'DB_NAME' 및 'DB_USER'는 여기에서만 설정할 수 있습니다.
- 런타임 Cloud Run에 이러한 변수를 설정할 수 있으며, CLI 또는 UI에서 모두 가능합니다. 여기에 4개의 변수를 모두 입력합니다(Dockerfile에 설정된 기본값을 유지하려는 경우 제외).
localhost에서 ENV 변수를 .env 파일에 넣을 수 있습니다(solutions 폴더 확인).
또한 .env가 .gitignore에 추가되었는지 확인하세요. 보안 비밀을 GitHub에 푸시하지 않아야 합니다.
echo .env >> .gitignore
그런 다음 로컬에서 인스턴스를 테스트할 수 있습니다.
docker run -it -p 8080:8080 --env-file .env my-php-app-docker
이제 다음을 달성했습니다.
- 앱이 ENV에서 변수를 동적으로 읽습니다.
- 코드에서 DB 비밀번호를 삭제하여 보안을 강화했습니다.
이제 Cloud Run에 새 버전을 배포할 수 있습니다. UI로 이동하여 환경 변수를 수동으로 설정해 보겠습니다.
- https://console.cloud.google.com/run으로 이동합니다.
- 앱을 클릭합니다.
- '새 버전 수정 및 배포'를 클릭합니다.
- 첫 번째 탭 '컨테이너'에서 하단 탭 '변수 및 보안 비밀'을 클릭합니다.
- '+ 변수 추가'를 클릭하고 필요한 모든 변수를 추가합니다. 다음과 같이 표시됩니다.


완벽한가요? 아니요. 대부분의 사업자는 여전히 PASS를 볼 수 있습니다. 이는 Google Cloud Secret Manager를 사용하여 완화할 수 있습니다.
두 번째 반복: Secret Manager
비밀번호가 코드에서 사라졌습니다. 성공입니다. 하지만 잠깐만요. 이제 안전한가요?
Google Cloud 콘솔에 액세스할 수 있는 모든 사용자가 비밀번호를 계속 볼 수 있습니다. 실제로 Cloud Run YAML 배포 파일에 액세스하면 이를 검색할 수 있습니다. 또는 새 Cloud Run 버전을 수정하거나 배포하려고 하면 아래 스크린샷과 같이 변수 및 보안 비밀 섹션에 비밀번호가 표시됩니다.
Google Cloud Secret Manager는 API 키, 비밀번호, 인증서, 기타 보안 비밀과 같은 민감한 정보를 관리하는 안전한 중앙 집중식 서비스입니다.
세분화된 권한과 강력한 암호화를 통해 보안 비밀을 저장, 관리, 액세스할 수 있습니다. Google Cloud의 Identity and Access Management(IAM)와 통합된 Secret Manager를 사용하면 특정 보안 비밀에 액세스할 수 있는 사용자를 제어하여 데이터 보안과 규정 준수를 보장할 수 있습니다.
또한 자동 보안 비밀 순환 및 버전 관리를 지원하여 보안 비밀 수명 주기 관리를 간소화하고 Google Cloud 서비스 전반의 애플리케이션 보안을 강화합니다.
Secret Manager에 액세스하려면 햄버거 메뉴에서 보안 서비스로 이동하여 아래 스크린샷과 같이 데이터 보호 섹션에서 찾습니다.

다음 이미지와 같이 Secret Manager API를 사용 설정합니다.

- 이제 '보안 비밀 만들기'를 클릭합니다. 합리적으로 이름을 지정해 보겠습니다.
- 이름:
php-amarcord-db-pass - 보안 비밀 값: 'DB 비밀번호'('파일 업로드' 부분은 무시)
- 이 보안 비밀 링크에 주석을 추가합니다.
projects/123456789012/secrets/php-amarcord-db-pass와 같이 표시됩니다. 보안 비밀에 대한 고유한 포인터입니다(Terraform, Cloud Run 등의 경우). 이 숫자는 고유한 프로젝트 번호입니다.
도움말: 보안 비밀에 일관된 이름 지정 규칙을 사용하고 왼쪽에서 오른쪽으로 구체화하세요. 예를 들면 cloud-devrel-phpamarcord-dbpass입니다.
- 조직(회사)
- 팀(조직 내)
- 애플리케이션(팀 내)
- 변수 이름(앱 내)
이렇게 하면 간단한 정규식을 사용하여 단일 앱의 모든 보안 비밀을 찾을 수 있습니다.
새 Cloud Run 버전 만들기
이제 새 보안 비밀이 준비되었으므로 DB_PASS ENV 변수를 삭제하고 새 보안 비밀로 대체해야 합니다. 따라서
- Google Cloud 콘솔을 사용하여 Cloud Run에 액세스
- 앱을 선택합니다.
- '새 버전 수정 및 배포'를 클릭합니다.
- '변수 및 보안 비밀' 탭을 찾습니다.
- '+ 보안 비밀 참조' 버튼을 사용하여 DB_PASS ENV 변수를 재설정합니다.
- 참조된 보안 비밀에 동일한 'DB_PASS'를 사용하고 최신 버전을 사용합니다.

완료되면 다음 오류가 표시됩니다.

해결 방법을 찾아보세요. 이 문제를 해결하려면 IAM 및 관리자 섹션에 액세스하여 부여 권한을 변경해야 합니다. 즐거운 디버깅 되세요!
문제를 파악한 후 Cloud Run으로 돌아가 새 버전을 다시 배포합니다. 다음 그림과 같은 결과가 표시됩니다.

도움말: Developer Console(UI)은 권한 문제를 지적하는 데 유용합니다. 시간을 내어 클라우드 항목의 모든 링크를 살펴보세요.
7. 모듈 5: Cloud Build로 CI/CD 설정

CI/CD 파이프라인을 사용하는 이유
지금쯤이면 gcloud run deploy를 여러 번 입력하고 동일한 질문에 반복적으로 답변했을 것입니다.
gcloud run deploy를 사용하여 앱을 수동으로 배포하는 데 지치셨나요? Git 저장소에 새 변경사항을 푸시할 때마다 앱이 자동으로 배포된다면 얼마나 좋을까요?
CI/CD 파이프라인을 사용하려면 다음 두 가지가 필요합니다.
- 개인 Git 저장소: 다행히 2단계에서 워크숍 저장소를 GitHub 계정으로 이미 포크했을 것입니다. 그렇지 않으면 뒤로 돌아가서 해당 단계를 완료합니다. 포크된 저장소는 다음과 같이 표시됩니다.
https://github.com/<YOUR_GITHUB_USER>/app-mod-workshop - Cloud Build. 이 놀랍고 저렴한 서비스를 사용하면 Terraform, Docker화된 앱 등 거의 모든 항목에 대한 빌드 자동화를 구성할 수 있습니다.
이 섹션에서는 Cloud Build 설정에 중점을 둡니다.
Cloud Build를 사용하세요
Cloud Build를 사용하여 이 작업을 수행합니다.
- 소스 빌드(Dockerfile 사용) 이를 빌드하고 실행하는 데 필요한 모든 항목('빌드 아티팩트')이 포함된 '대형 .zip 파일'이라고 생각하면 됩니다.
- 이 아티팩트를 Artifact Registry(AR)로 푸시합니다.
- 그런 다음 AR에서 Cloud Run으로 'php-amarcord' 앱을 배포합니다.
- 이렇게 하면 기존 앱의 새 버전('버전')이 생성되고(새 코드가 있는 레이어라고 생각하면 됨) 푸시가 성공하면 트래픽을 새 버전으로 전환하도록 구성됩니다.
다음은 php-amarcord 앱의 빌드 예시입니다.

이 모든 것을 어떻게 할 수 있을까요?
- 완벽한 YAML 파일 하나를 작성합니다.
cloudbuild.yaml - Cloud Build 빌드 트리거를 만듭니다.
- Cloud Build UI를 통해 GitHub 저장소에 연결합니다.
트리거 만들기(및 저장소 연결)
- https://console.cloud.google.com/cloud-build/triggers로 이동합니다.
- '트리거 만들기'를 클릭합니다.
- 컴파일:
- 이름:
on-git-commit-build-php-app와 같이 의미 있는 이름 - 이벤트: 브랜치로 푸시
- 소스: '새 저장소 연결'

- 그러면 오른쪽에 '저장소 연결' 창이 열립니다.
- 소스 제공업체: 'Github'(첫 번째)
- "계속"
- '인증'을 클릭하면 GitHub에 교차 인증을 위한 창이 열립니다. 흐름을 따르고 인내심을 가지세요. 저장소가 많으면 시간이 걸릴 수 있습니다.
- '저장소 선택'에서 계정/저장소를 선택하고 '이해합니다…' 부분을 선택합니다.
- 오류가 발생한 경우: 저장소에 GitHub 앱이 설치되지 않았습니다. 'Google Cloud Build 설치'를 클릭하고 안내를 따르세요.
'연결'을 클릭합니다.
- 맞습니다. 이제 저장소가 연결되었습니다.
- 트리거 부분으로 돌아가겠습니다.
- 구성: 자동 감지됨(*)
- 고급: '[PROJECT_NUMBER]- compute@developer.gserviceaccount.com' 서비스 계정을 선택합니다.
- xxxxx는 프로젝트 ID입니다.
- 기본 컴퓨팅 서비스 계정은 실습 접근 방식에 적합합니다. 프로덕션에서는 사용하지 마세요. (자세히 알아보기)
- 나머지는 그대로 둡니다.
- '만들기' 버튼을 클릭합니다.
(*) Dockerfile 또는 cloudbuild.yaml을 확인하므로 가장 간단한 방법입니다. 하지만 cloudbuild.yaml를 사용하면 어떤 단계에서 무엇을 할지 결정할 수 있는 실질적인 권한이 부여됩니다.
I've got the power!
이제 Cloud Build 서비스 계정(서비스 계정이란 무엇인가요? 작업을 대신 수행하는 '로봇'의 이메일입니다. 이 경우에는 Cloud에서 빌드하는 작업을 수행합니다.
SA가 빌드 및 배포를 수행할 수 있도록 권한을 부여하지 않으면 빌드 및 배포가 실패합니다. 다행히도 간단합니다.
- 'Cloud Build' > '설정'으로 이동합니다.
- '[PROJECT_NUMBER]- compute@developer.gserviceaccount.com' 서비스 계정
- 다음 체크박스를 선택합니다.
- Cloud Run
- Secret Manager
- 서비스 계정
- Cloud Build
- '선호하는 서비스 계정으로 설정'도 선택합니다.

Cloud Build YAML은 어디에 있나요?
자체 Cloud Build YAML을 만드는 데 시간을 할애하는 것이 좋습니다.
하지만 시간이 없거나 시간을 내고 싶지 않다면 .solutions 폴더에서 아이디어를 얻을 수 있습니다.
이제 GitHub에 변경사항을 푸시하고 Cloud Build가 작동하는지 확인할 수 있습니다.
Cloud Build 설정은 까다로울 수 있습니다. 다음과 같은 방법으로 의견을 주고받을 수 있습니다.
- https://console.cloud.google.com/cloud-build/builds;region=global에서 로그 확인
- 오류를 찾는 중입니다.
- 코드에서 수정하고 git commit/git push를 다시 실행합니다.
- 코드에 오류가 있는 것이 아니라 구성에 오류가 있는 경우도 있습니다. 이 경우 UI(Cloud Build > '트리거' > 실행)에서 새 빌드를 실행할 수 있습니다.

이 솔루션을 사용하는 경우에도 몇 가지 작업이 필요합니다. 예를 들어 새로 생성된 dev/prod 엔드포인트에 대한 ENV 변수를 설정해야 합니다.

여기에는 두 가지 방법이 있습니다.
- UI를 통해 - ENV 변수를 다시 설정
- CLI를 통해 '완벽한' 스크립트를 작성합니다. 예시는 gcloud-run-deploy.sh에서 확인할 수 있습니다. 엔드포인트 및 프로젝트 번호와 같은 몇 가지 사항을 조정해야 합니다. 프로젝트 번호는 Cloud 개요에서 확인할 수 있습니다.
GitHub에 코드를 커밋하려면 어떻게 해야 하나요?
GitHub에 git push하는 가장 좋은 방법을 가르치는 것은 이 워크숍의 범위를 벗어납니다. 하지만 Cloud Shell에서 문제가 발생한 경우 다음 두 가지 방법이 있습니다.
- CLI 로컬에 SSH 키를 추가하고 git@github.com:YOUR_USER/app-mod-workshop.git(http 대신)을 사용하여 원격을 추가합니다.
- VSCode Cloud Shell 편집기를 사용하는 경우 소스 제어(Ctrl-Shift-G) 탭을 사용하고 '변경사항 동기화'를 클릭한 후 안내를 따르세요. GitHub 계정을 VS Code에 인증할 수 있어야 하며, 그러면 VS Code에서 가져오기/내보내기가 매우 쉬워집니다.

다른 파일 중에서 git add clodubuild.yaml해야 합니다. 그렇지 않으면 작동하지 않습니다.
'개발/프로덕션 패리티'의 깊이[선택사항]
여기에서 모델 버전을 복사한 경우 동일한 DEV 및 PROD 버전이 두 개 생성됩니다. 이는 Twelve-Factor App의 규칙 10에 부합하는 멋진 기능입니다.
하지만 두 개의 서로 다른 웹 엔드포인트를 사용하여 앱이 동일한 데이터베이스를 가리키도록 하고 있습니다. 워크숍에서는 이 정도로 충분하지만 실제로는 적절한 프로덕션 환경을 만드는 데 시간을 할애해야 합니다. 즉, 데이터베이스가 두 개(개발용과 프로덕션용) 있고 재해 복구/고가용성을 위해 데이터베이스를 어디에 둘지 선택해야 합니다. 이 워크숍의 범위를 벗어나는 내용이지만 생각해 볼 만한 주제입니다.
'심층' 버전의 프로덕션을 진행할 시간이 있다면 다음과 같이 복제해야 하는 모든 리소스를 염두에 두세요.
- Cloud SQL 데이터베이스(및 SQL 인스턴스)
- GCS 버킷
- Cloud 함수
- 개발 단계에서는 Gemini 1.5 Flash(더 저렴하고 빠름)를 모델로 사용하고, Gemini 1.5 Pro(더 강력함)를 사용할 수 있습니다.
일반적으로 앱과 관련된 작업을 할 때마다 프로덕션에 동일한 값이 있어야 하는지 비판적으로 생각해야 합니다. 그렇지 않다면 노력을 배가하세요. 물론 Terraform을 사용하면 환경(-dev, -prod)을 리소스의 서픽스로 삽입할 수 있으므로 이 작업이 훨씬 더 쉬워집니다.
8. 모듈 6: Google Cloud Storage로 이동

스토리지

현재 앱은 Docker 컨테이너에 상태를 저장합니다. 머신이 고장 나거나 앱이 폭발하거나 단순히 새 버전을 푸시하는 경우 새 버전이 예약되고 새로운 빈 스토리지가 생성됩니다. 🙈
이 문제를 어떻게 해결할 수 있을까요? 여러 가지 방법이 있습니다.
- DB에 이미지를 저장합니다. 이전 PHP 앱에서 결국 그렇게 했습니다. 복잡성을 더하지 않으므로 가장 간단한 솔루션입니다. 하지만 DB에 지연 시간과 부하가 추가되는 것은 확실합니다.
- Cloud Run 앱을 스토리지 친화적인 솔루션인 GCE + Persistent Disk로 마이그레이션하시겠어요? 어쩌면 GKE + 스토리지일 수도 있겠네요? 참고: 제어력이 높아지면 민첩성이 떨어집니다.
- GCS로 이동합니다. Google Cloud Storage는 Google Cloud 전체에 동급 최고의 스토리지를 제공하며 가장 클라우드에 적합한 솔루션입니다. 하지만 PHP 라이브러리를 직접 다뤄야 합니다. GCS용 PHP 5.7 라이브러리가 있나요?
PHP 5.7에서Composer를 지원하나요? Composer에서 지원하는 가장 이른 버전은 PHP 5.3.2인 것 같습니다. - Docker 사이드카를 사용해야 할까요?
- 또는 GCS Cloud Run 볼륨 마운트를 사용합니다. 정말 놀랍지 않나요?
🤔 스토리지 이전(직접 기재)
[개방형] 이 연습에서는 이미지를 어떤 방식으로든 유지되는 방식으로 이동하는 솔루션을 찾아야 합니다.
승인 테스트
해결책을 알려주고 싶지는 않지만 다음과 같은 결과가 나오기를 원합니다.
newpic.jpg을(를) 업로드합니다. 앱에서 확인합니다.- 앱을 새 버전으로 업그레이드합니다.
newpic.jpg는 그대로 표시됩니다.
💡 가능한 해결 방법(GCS Cloud Run 볼륨 마운트)
이는 이미지 설명을 표시하는 것 외에는 코드를 전혀 건드리지 않고도 스테이트풀(Stateful) 파일 업로드를 달성할 수 있는 매우 우아한 솔루션입니다.
이렇게 하면 Cloud Run에서 GCS로 폴더를 마운트할 수 있습니다.
- GCS에 업로드된 모든 항목이 앱에 실제로 표시됩니다.
- 앱에 업로드하는 모든 항목이 실제로 GCS에 업로드됩니다.
- GCS에 업로드된 객체에 마법이 일어납니다(7장).
참고: FUSE 세부사항을 읽어보세요. 성능이 문제가 되는 경우에는 이 방법이 적합하지 않습니다.
GCS 버킷 만들기
GCS는 Google Cloud의 전방위 스토리지 서비스입니다. 실전에서 검증되었으며 스토리지가 필요한 모든 GCP 서비스에서 사용됩니다.
Cloud Shell은 PROJECT_ID를 GOOGLE_CLOUD_PROJECT로 내보냅니다.
$ export PROJECT_ID=$GOOGLE_CLOUD_PROJECT
#!/bin/bash
set -euo pipefail
# Your Cloud Run Service Name, eg php-amarcord-dev
SERVICE_NAME='php-amarcord-dev'
BUCKET="${PROJECT_ID}-public-images"
GS_BUCKET="gs://${BUCKET}"
# Create bucket
gsutil mb -l "$GCP_REGION" -p "$PROJECT_ID" "$GS_BUCKET/"
# Copy original pictures there - better if you add an image of YOURS before.
gsutil cp ./uploads/*.png "$GS_BUCKET/"
/uploads/ 폴더에 버킷을 마운트하도록 Cloud Run 구성
이제 우아한 부분으로 넘어가겠습니다. 볼륨 php_uploads을 만들고 Cloud Run에 MOUNT_PATH(/var/www/html/uploads/ 등)에서 FUSE 마운트를 수행하도록 지시합니다.
#!/bin/bash
set -euo pipefail
# .. keep variables from previous script..
# Uploads folder within your docker container.
# Tweak it for your app code.
MOUNT_PATH='/var/www/html/uploads/'
# Inject a volume mount to your GCS bucket in the right folder.
gcloud --project "$PROJECT_ID" beta run services update "$SERVICE_NAME" \
--region $GCP_REGION \
--execution-environment gen2 \
--add-volume=name=php_uploads,type=cloud-storage,bucket="$BUCKET" \
--add-volume-mount=volume=php_uploads,mount-path="$MOUNT_PATH"
이제 Cloud Storage를 가리키려는 모든 엔드포인트에 대해 이 단계를 반복합니다.
UI에서도 동일한 작업을 수행할 수 있습니다.
- '볼륨' 탭에서 버킷을 가리키는 'Cloud Storage 버킷' 유형의 볼륨 마운트를 만듭니다(예: 이름 'php_uploads').
- 컨테이너 > 볼륨 마운트에서 방금 만든 볼륨을 앱에서 요청한 볼륨 지점에 마운트합니다. Dockerfile에 따라 다르지만
var/www/html/uploads/과 같이 표시될 수 있습니다.
어느 쪽이든 작동한다면 새 Cloud Run 버전을 수정할 때 다음과 같이 표시됩니다.

이제 /upload.php 엔드포인트에 새 이미지를 업로드하여 새 애플리케이션을 테스트합니다.
PHP를 한 줄도 작성하지 않고도 이미지가 GCS에서 원활하게 전송되어야 합니다.

어떻게 된 것인가요?
마법 같은 일이 일어났습니다.
오래된 코드가 있는 오래된 애플리케이션이 여전히 작동하고 있습니다. 새로운 현대화된 스택을 사용하면 앱의 모든 이미지/사진을 스테이트풀(Stateful) Cloud 버킷에 편안하게 저장할 수 있습니다. 이제 한계는 없습니다.
- '위험' 또는 '과도한 노출'이 포함된 이미지가 들어올 때마다 이메일을 보내고 싶으신가요? PHP 코드를 건드리지 않고도 이 작업을 수행할 수 있습니다.
- 이미지가 들어올 때마다 Gemini 멀티모달 모델을 사용하여 이미지를 설명하고 설명과 함께 DB를 업로드하고 싶으신가요? PHP 코드를 건드리지 않고도 이 작업을 수행할 수 있습니다. 못 믿겠어? 7장에서 계속 읽어보세요.
여기에서 큰 기회의 공간을 열었습니다.
9. 모듈 7: Google Gemini로 앱 강화하기

이제 클라우드화된 스토리지를 갖춘 멋지고 현대화된 새로운 PHP 앱(예: 2024 Fiat 126)이 완성되었습니다.
필드로 할 수 있는 작업
기본 요건
이전 장에서는 모델 솔루션을 통해 GCS에 이미지 /uploads/를 마운트하여 사실상 앱 로직을 이미지 스토리지에서 분리할 수 있었습니다.
이 연습을 수행하려면 다음이 필요합니다.
- 6장(스토리지)의 실습을 완료했습니다.
- 이미지 업로드가 포함된 GCS 버킷이 있습니다. 사용자가 앱에 사진을 업로드하면 사진이 버킷으로 전송됩니다.
Cloud 함수 설정(Python)
이벤트 기반 애플리케이션을 구현하는 방법이 궁금하신가요? 예를 들면 다음과 같습니다.
- <event>가 발생하면 이메일 전송
- <event>가 발생하면 => <condition>이 true인 경우 데이터베이스를 업데이트합니다.
이벤트는 BigQuery에서 사용할 수 있는 새 레코드, GCS의 폴더에서 변경된 새 객체, Pub/Sub의 큐에서 대기 중인 새 메시지 등 무엇이든 될 수 있습니다.
Google Cloud는 이를 달성하기 위해 여러 패러다임을 지원합니다. 특히 다음 항목에 주의해야 합니다.
- EventArc GCS 이벤트를 수신하는 방법을 알아보세요. 클라우드에서 if-then-else를 기반으로 DAG를 만들고 작업을 조정하는 데 유용합니다.
- Cloud Scheduler 예를 들어 클라우드에서 자정에 실행되는 크론 작업에 적합합니다.
- Cloud Workflows Eventarc와 마찬가지로
- Cloud Run Functions(
lambdas라고도 함) - Cloud Composer. 기본적으로 Apache Airflow의 Google 버전이며 DAG에도 적합합니다.
이 연습에서는 Cloud Functions를 자세히 살펴보고 놀라운 결과를 얻을 것입니다. 선택적 연습도 제공됩니다.
샘플 코드는 .solutions/에서 제공됩니다.
Cloud 함수 설정(🐍 Python)
Google은 매우 야심 찬 GCF를 만들고자 합니다.
- GCS에 새 이미지가 생성되면.. (누군가 앱에 업로드했을 가능성이 높지만, 이 경우에만 해당하는 것은 아님)
- .. Gemini를 호출하여 이미지를 설명하고 이미지의 텍스트 설명을 가져옵니다 .. (MIME을 확인하여 PDF, MP3 또는 텍스트가 아닌 이미지인지 확인하는 것이 좋습니다.)
- .. and update the DB with this description. (이를 위해서는 DB를 패치하여
images테이블에description열을 추가해야 할 수 있음)
DB를 패치하여 이미지에 description 추가
- Cloud SQL Studio를 엽니다.

- 이미지 DB의 사용자 및 비밀번호를 입력합니다.
- 이미지 설명을 위한 열을 추가하는 다음 SQL을 삽입합니다.
ALTER TABLE images ADD COLUMN description TEXT;

빙고! 지금 시도하여 작동하는지 확인합니다.
SELECT * FROM images;
새 설명 열이 표시됩니다.

Gemini f(x) 작성
참고: 이 함수는 실제로 Gemini Code Assist의 도움을 받아 생성되었습니다.
참고: 이 함수를 만들면 IAM 권한 오류가 발생할 수 있습니다. 일부는 아래의 '발생 가능한 오류' 단락에 설명되어 있습니다.
- API 사용 설정
- https://console.cloud.google.com/functions/list로 이동합니다.
- '함수 만들기'를 클릭합니다.
- API 마법사에서 API를 사용 설정합니다.

UI 또는 명령줄에서 GCF를 만들 수 있습니다. 여기서는 명령줄을 사용합니다.
.solutions/에서 가능한 코드를 찾을 수 있습니다.
- 코드를 호스팅할 폴더를 만듭니다(예: 'gcf/'). 폴더를 입력합니다.
requirements.txt파일을 만듭니다.
google-cloud-storage
google-cloud-aiplatform
pymysql
- Python 함수를 만듭니다. 샘플 코드: gcf/main.py
#!/usr/bin/env python
"""Complete this"""
from google.cloud import storage
from google.cloud import aiplatform
import vertexai
from vertexai.generative_models import GenerativeModel, Part
import os
import pymysql
import pymysql.cursors
# Replace with your project ID
PROJECT_ID = "your-project-id"
GEMINI_MODEL = "gemini-1.5-pro-002"
DEFAULT_PROMPT = "Generate a caption for this image: "
def gemini_describe_image_from_gcs(gcs_url, image_prompt=DEFAULT_PROMPT):
pass
def update_db_with_description(image_filename, caption, db_user, db_pass, db_host, db_name):
pass
def generate_caption(event, context):
"""
Cloud Function triggered by a GCS event.
Args:
event (dict): The dictionary with data specific to this type of event.
context (google.cloud.functions.Context): The context parameter contains
event metadata such as event ID
and timestamp.
"""
pass
- 함수를 푸시합니다. gcf/push-to-gcf.sh와 유사한 스크립트를 사용할 수 있습니다.
참고 1. 올바른 값으로 ENV를 소싱하거나 상단에 추가합니다(GS_BUCKET=blah, ..).
참고 2. 이렇게 하면 모든 로컬 코드(.)가 푸시되므로 코드를 특정 폴더에 넣고 .gcloudignore를 전문가처럼 사용하여 대규모 라이브러리를 푸시하지 않도록 합니다. (예시)
#!/bin/bash
set -euo pipefail
# add your logic here, for instance:
source .env || exit 2
echo "Pushing ☁️ f(x)☁ to 🪣 $GS_BUCKET, along with DB config.. (DB_PASS=$DB_PASS)"
gcloud --project "$PROJECT_ID" functions deploy php_amarcord_generate_caption \
--runtime python310 \
--region "$GCP_REGION" \
--trigger-event google.cloud.storage.object.v1.finalized \
--trigger-resource "$BUCKET" \
--set-env-vars "DB_HOST=$DB_HOST,DB_NAME=$DB_NAME,DB_PASS=$DB_PASS,DB_USER=$DB_USER" \
--source . \
--entry-point generate_caption \
--gen2
참고: 이 예시에서 generate_caption는 호출된 메서드이며 Cloud 함수는 모든 관련 정보(버킷 이름, 객체 이름 등)와 함께 GCS 이벤트를 전달합니다. 시간을 내어 이벤트 Python dict를 디버깅하세요.
함수 테스트
단위 테스트
이 함수에는 많은 가변적인 부분이 있습니다. 모든 단일 테스트를 테스트할 수 있습니다.
예시는 gcf/test.py에 있습니다.
Cloud Functions UI
UI에서 함수를 살펴보는 시간도 가져보세요. 모든 탭을 살펴볼 가치가 있으며, 특히 Source(제가 가장 좋아하는 탭), Variables, Trigger, Logs 탭을 살펴보세요. 오류를 해결하기 위해 Logs에서 많은 시간을 보내게 될 것입니다(이 페이지 하단에서 발생할 수 있는 오류도 참고하세요). Permissions도 확인하세요.

E2E 테스트
이제 함수를 수동으로 테스트해 보겠습니다.
- 앱으로 이동하여 로그인합니다.
- 사진을 업로드합니다(너무 크지 않아야 함, 큰 이미지의 경우 문제가 발생할 수 있음).
- UI에서 사진이 업로드되었는지 확인합니다.
- Cloud SQL Studio에서 설명이 업데이트되었는지 확인합니다. 로그인하고
SELECT * FROM images쿼리를 실행합니다.

그 효과는 매우 뛰어났습니다. 또한 설명을 표시하도록 프런트엔드를 업데이트할 수도 있습니다.
[선택사항]을 표시하도록 PHP 업데이트
앱이 작동하는 것을 확인했습니다. 하지만 사용자도 이 설명을 볼 수 있으면 좋겠습니다.
index.php에 설명을 추가하기 위해 PHP 전문가가 될 필요는 없습니다. 이 코드는 다음과 같습니다(Gemini가 작성해 준 코드입니다).
<?php if (!empty($image['description'])): ?>
<p class="font-bold">Gemini Caption:</p>
<p class="italic"><?php echo $image['description']; ?></p>
<?php endif; ?>
이 코드를 원하는 대로 foreach 내부에 배치합니다.
다음 단계에서는 Gemini Code Assist를 사용하여 더 깔끔한 UI 버전도 확인할 수 있습니다. 예쁜 버전은 다음과 같습니다.

결론
GCS에 새 객체가 업로드되면 Cloud 함수가 트리거되어 사람이 하는 것처럼 이미지 콘텐츠에 주석을 달고 DB를 자동으로 업데이트할 수 있습니다. 와우!
다음 단계 동일한 논리를 따라 두 가지 뛰어난 기능을 구현할 수 있습니다.
[선택사항] Cloud Functions 추가 [자유 형식]
몇 가지 추가 기능이 떠오릅니다.
📩 이메일 트리거
누군가 사진을 보낼 때마다 이메일을 보내는 이메일 트리거
- 너무 자주 표시되나요? 추가 제약 조건: 큰 사진 또는 Gemini 콘텐츠에 '누드/과도한 노출/폭력'이라는 단어가 포함된 사진
EventArc에서 확인해 보세요.
🚫 부적절한 사진 자동 관리
현재는 관리자가 '부적절'한 이미지를 신고하고 있습니다. Gemini가 까다로운 작업을 처리하고 스페이스를 관리하도록 하면 어떨까요? 이전 함수에서 배운 대로 부적절한 트리거 콘텐츠를 신고하고 DB를 업데이트하는 테스트를 추가합니다. 즉, 기본적으로 이전 함수를 가져와 프롬프트를 변경하고 답변을 기반으로 DB를 업데이트합니다.
주의사항. 생성형 AI는 예측할 수 없는 출력을 생성합니다. Gemini의 '창의적인 출력'이 '정해진 규칙'을 따르도록 합니다. 0~1 사이의 신뢰도 점수, JSON 등 결정론적 답변을 요청할 수 있습니다. 이는 다음과 같은 다양한 방법으로 달성할 수 있습니다. * Python 라이브러리 pydantic, langchain 등을 사용합니다. * Gemini 구조화된 출력을 사용합니다.
도움말. 여러 함수를 사용하거나 JSON 답변을 적용하는 단일 프롬프트를 사용할 수 있습니다(위에서 강조 표시된 'Gemini 구조화된 출력'과 함께 사용하면 효과적임).
이러한 결과를 생성하려면 어떤 프롬프트를 사용해야 할까요?
{
"description": "This is the picture of an arrosticino",
"suitable": TRUE
}
프롬프트에 추가 필드를 추가하여 '좋은 점이 있나요?'와 같은 유용한 정보를 얻을 수 있습니다. 나쁜 점은 무엇인가요? 이 장소를 알고 계시나요? 텍스트가 있는 경우(OCR이 그 어느 때보다 쉬워짐):
goods: '맛있는 음식 같아'bads: '건강에 좋지 않은 음식처럼 보입니다.'OCR: "Da consumare preferibilmente prima del 10 Novembre 2024"location: 'Pescara, Lungomare'
일반적으로 N개의 결과에 대해 N개의 함수를 사용하는 것이 좋지만, 10가지 작업을 수행하는 함수를 하나 만드는 것도 매우 보람 있는 일입니다. 방법은 리카르도의 도움말을 참고하세요.
발생할 수 있는 오류(대부분 IAM/권한)
이 솔루션을 처음 개발했을 때 IAM 권한 문제가 발생했습니다. 공감을 표현하고 해결 방법에 관한 아이디어를 제공하기 위해 여기에 추가하겠습니다.
오류: 서비스 계정에 대한 권한이 충분하지 않음
- GCS 버킷을 리슨하는 GCF 함수를 배포하려면 그림과 같이 작업에 사용하는 서비스 계정에 적절한 권한을 설정해야 합니다.

EventArc API도 사용 설정해야 할 수 있습니다. 완전히 사용할 수 있게 되기까지 몇 분 정도 걸립니다.
오류: Cloud Run 호출자 누락
- GCF 권한 부여를 위한 UI의 또 다른 주석은 다음과 같습니다(Cloud Run 호출자 역할).

이 오류는 이미지에서 fix-permissions.sh와 유사한 명령어를 실행하여 해결할 수 있습니다.
이 문제는 https://cloud.google.com/functions/docs/securing/authenticating에 설명되어 있습니다.
오류: 메모리 한도 초과
처음 실행했을 때 로그에 '270MiB가 사용되어 메모리 한도인 244MiB를 초과했습니다. 메모리 한도를 늘리는 것이 좋습니다. https://cloud.google.com/functions/docs/configuring/memory를 참조하세요.'" 다시 GCF에 RAM을 추가합니다. UI에서 매우 쉽게 할 수 있습니다. 다음과 같은 후속 이메일을 보낼 수 있습니다.

또는 Cloud Run 배포 스크립트를 수정하여 MEM/CPU를 늘릴 수도 있습니다. 시간이 조금 더 걸립니다.
오류: Pub/Sub 게시됨
GCF v1로 트리거를 만들 때 이 오류가 한 번 발생했습니다.

이 문제는 IAM으로 이동하여 서비스 계정에 'Pub/Sub 게시자' 역할을 부여하면 쉽게 해결할 수 있습니다.
오류: Vertex AI가 사용되지 않음
이 오류가 표시되는 경우:
권한 거부됨: 403 Vertex AI API가 이전에 YOUR_PROJECT 프로젝트에서 사용되지 않았거나 사용 중지되었습니다. https://console.developers.google.com/apis/api/aiplatform.googleapis.com/overview?project=YOR_PROJECT 페이지를 방문하여 사용 설정하세요.
Vertex AI API를 사용 설정하기만 하면 됩니다. 필요한 모든 API를 사용 설정하는 가장 쉬운 방법은 다음과 같습니다.
- https://console.cloud.google.com/vertex-ai
- '모든 권장 API 사용 설정'을 클릭합니다.

오류: EventArc 트리거를 찾을 수 없습니다.
이 오류가 발생하면 함수를 다시 배포하세요.

오류: 400 서비스 에이전트가 프로비저닝 중임
400 서비스 에이전트가 프로비저닝되고 있습니다(https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents). 제공된 Cloud Storage 파일을 읽으려면 서비스 에이전트가 필요합니다. 잠시 후에 다시 시도해 주세요.
이 경우 잠시 기다리거나 Google 직원에게 문의하세요.
10. 모듈 8: 가용성 SLO 만들기
이 챕터에서는 다음을 달성하려고 합니다.
- SLI 만들기
- SLI를 기반으로 SLO 만들기
- SLO 기반 알림 만들기

리카르도는 Google Cloud의 SRE/DevOps 영역에서 일하고 있으므로 이 주제는 저자에게 매우 중요한 주제입니다.
(개방형) 이 앱의 SLI 및 SLO 만들기
앱이 다운되었을 때 알 수 없다면 앱이 얼마나 좋을까요?
SLO란 무엇인가요?
이런, Google에서 SLO를 만들었습니다. 자세한 내용은 다음을 참고하세요.
- SRE 도서 - 2장 - SLO 구현 (👉 SRE 도서 더보기)
- SLO의 기술(멋진 동영상) 서비스에 적합한 완벽한 SLO를 만드는 방법을 자세히 알아볼 수 있는 훌륭한 교육입니다.
- Coursera의 SRE 과정. 내가 기여했어!
1단계: 가용성 SLI/SLO 만들기
가용성 SLO부터 시작해 보겠습니다. 가용성 SLO는 가장 쉽고 측정해야 할 가장 중요한 항목일 수 있습니다.
다행히 Cloud Run은 Istio 덕분에 사전 빌드된 SLO 지원을 제공합니다.
앱이 Cloud Run에 있으면 이 작업은 매우 간단하며 30초밖에 걸리지 않습니다.
- Cloud Run 페이지로 이동합니다.
- 앱을 클릭/선택합니다.
SLOs탭을 선택합니다.- '+ SLO 만들기'를 클릭합니다.
- 가용성, 요청 기반
- 계속
- 캘린더 월/99%
- 'SLO 만들기'를 클릭합니다.

2단계: 이 SLO에 알림 설정
알림을 2개 만드는 것이 좋습니다.
- 낮은 소진율('Slowburn')을 가진 하나는 이메일을 통해 알림을 보냅니다(우선순위가 낮은 티켓을 시뮬레이션함).
- SMS를 통해 알림을 보내는 높은 소진율('Fastburn')이 있는 알림(우선순위가 높은 티켓/무선 호출기 시뮬레이션)
이전의 SLO tab으로 이동합니다.
다음 작업을 두 번 수행합니다.

- 'SLO 알림 만들기'(오른쪽에 더하기 기호가 있는 🔔 버튼)를 클릭합니다.
- 대상 기간, 소진율 기준:
- [FAST]. 첫 번째:
60분/10회 - [SLOW]. 두 번째:
720분/2회 - 알림 채널: 알림 채널 관리를 클릭합니다.
- 먼저 '이메일' -> 새로 추가 -> ..
- 둘째, 'SMS' -> 새로 추가 -> 휴대전화에서 인증합니다.
- 도움말: 이름에 그림 이모티콘을 사용하는 것이 좋습니다. 데모용으로 재미있습니다.
- 완료되면 오른쪽 상단의 큰 X를 클릭합니다.
- 전화를 먼저 선택하고(빠름) 이메일을 다음으로 선택합니다(느림).
- 다음과 같은 샘플 문서를 추가합니다.
[PHP Amarcord] Riccardo told me to type sudo reboot or to check documentation in http://example.com/playbooks/1.php but I guess he was joking.
맞습니다.
최종 결과
가용성에 대한 작동하는 SLO 1개와 알림 2개가 있고 이메일과 휴대전화로 알림이 전송되면 이 연습이 완료된 것으로 간주할 수 있습니다.
원하는 경우 지연 시간을 추가하거나 더 복잡한 제약 조건을 추가할 수도 있습니다(적극 권장). 지연 시간의 경우 적절하다고 생각되는 지연 시간을 선택합니다. 확실하지 않은 경우 200ms를 선택합니다.
11. 다음 단계
모든 작업을 완료했는데 무엇이 누락되었나요?
생각해 볼 만한 주제:
Gemini와 함께 플레이
Gemini는 두 가지 방식으로 사용할 수 있습니다.
- Vertex AI 7장(GCF+Gemini)에서 살펴본 GCP와 연계된 '엔터프라이즈 방식' 모든 인증이 마법처럼 작동하고 서비스가 아름답게 상호 연결됩니다.
- Google AI '소비자 방식' 여기에서 Gemini API 키를 가져와 이미 보유한 워크로드(독점 작업, 다른 클라우드, localhost 등)에 연결할 수 있는 작은 스크립트를 빌드하기 시작합니다. API 키를 대체하기만 하면 코드가 마법처럼 작동하기 시작합니다.
자체 프로젝트를 통해 (2)을(를) 살펴보시기 바랍니다.
UI Lifting
UI를 잘 다루지 못합니다. 하지만 Gemini는 가능합니다. 단일 PHP 페이지를 가져와 다음과 같이 작성할 수 있습니다.
I have a VERY old PHP application. I want to touch it as little as possible. Can you help me:
1. add some nice CSS to it, a single static include for tailwind or similar, whatever you prefer
2. Transform the image print with description into cards, which fit 4 per line in the canvas?
Here's the code:
-----------------------------------
[Paste your PHP page, for instance index.php - mind the token limit!]
Cloud Build를 사용하면 5분 이내에 쉽게 이 작업을 수행할 수 있습니다. :)
Gemini의 대답이 완벽했습니다(즉, 아무것도 변경할 필요가 없었음).

작성자의 개인 앱에 표시되는 새로운 레이아웃은 다음과 같습니다.

참고: 코드를 그대로 가져오는 것을 권장하지 않기 때문에 코드는 이미지로 붙여넣었습니다. Gemini가 자체적인 창의적 UI/프런트엔드 제약 조건에 따라 코드를 작성하도록 하세요. 이후에는 아주 사소한 변경사항만 남게 됩니다.
보안
이 앱을 적절하게 보호하는 것은 이 4시간 워크숍의 목표가 아닙니다. 이 워크숍을 완료하는 데 걸리는 시간이 1~2배 늘어날 수 있기 때문입니다.
하지만 이 주제는 매우 중요합니다. SECURITY에서 몇 가지 아이디어를 수집했습니다.
12. 수고하셨습니다
축하합니다. 🎉🎉🎉 Google Cloud를 사용하여 기존 PHP 애플리케이션을 현대화했습니다.

이 Codelab에서 알아본 내용은 다음과 같습니다.
- Google Cloud SQL에서 데이터베이스를 배포하는 방법과 기존 데이터베이스를 Google Cloud SQL로 마이그레이션하는 방법
- Docker 및 Buildpacks를 사용하여 PHP 애플리케이션을 컨테이너화하고 이미지를 Google Cloud Artifact Registry에 저장하는 방법
- 컨테이너화된 앱을 Cloud Run에 배포하고 Cloud SQL과 함께 실행하는 방법
- Google Secret Manager를 사용하여 민감한 구성 매개변수(예: DB 비밀번호)를 비밀리에 저장/사용하는 방법
- Google Cloud Build를 사용하여 CI/CD 파이프라인을 설정하고 GitHub 저장소에 코드를 푸시할 때마다 PHP 앱을 자동으로 빌드하고 배포하는 방법
- Cloud Storage를 사용하여 앱 리소스를 '클라우드화'하는 방법
- 서버리스 기술을 활용하여 앱 코드를 건드리지 않고도 Google Cloud에서 놀라운 워크플로를 빌드하는 방법
- 적절한 사용 사례에 Gemini 멀티모달 기능을 사용합니다.
- Google Cloud 내에서 SRE 원칙 구현
Google Cloud를 사용한 애플리케이션 현대화 여정을 시작하는 데 도움이 될 것입니다.
🔁 의견
이 워크숍에 대한 경험을 공유하려면 이 의견 양식을 작성해 주세요.
여러분의 의견과 특히 자랑스럽게 생각하는 코드 조각에 대한 PR을 환영합니다.
🙏 감사합니다.
작성자는 솔루션 작성 및 테스트에 도움을 준 Datatonic의 미르코 길리올리와 마우리치오 입살레에게 감사를 표합니다.
