로드 중...
검색 결과가 없습니다.

Google Cloud 콘솔에서 기술 적용

실습 설정 안내 및 요구사항
계정과 진행 상황을 보호하세요. 이 실습을 실행하려면 항상 시크릿 브라우저 창과 실습 사용자 인증 정보를 사용하세요.

Deploy a Static Site with Nginx on Google Cloud Run using Artifact Registry

실습 30분 universal_currency_alt 크레딧 1개 show_chart 입문
info 이 실습에는 학습을 지원하는 AI 도구가 통합되어 있을 수 있습니다.
이 콘텐츠는 아직 휴대기기에 최적화되지 않음
최상의 경험을 위해 데스크톱 컴퓨터에서 이메일로 전송된 링크를 사용하여 방문하세요.

gem-cloud-run-nginx-website

Google Cloud self-paced labs logo

Activate Cloud Shell

Cloud Shell is a virtual machine that is loaded with development tools. It offers a persistent 5GB home directory and runs on the Google Cloud. Cloud Shell provides command-line access to your Google Cloud resources.

  1. Click Activate Cloud Shell Activate Cloud Shell icon at the top of the Google Cloud console.

When you are connected, you are already authenticated, and the project is set to your PROJECT_ID. The output contains a line that declares the PROJECT_ID for this session:

Your Cloud Platform project in this session is set to YOUR_PROJECT_ID

gcloud is the command-line tool for Google Cloud. It comes pre-installed on Cloud Shell and supports tab-completion.

  1. (Optional) You can list the active account name with this command:
gcloud auth list

  1. Click Authorize.

  2. Your output should now look like this:

Output:

ACTIVE: * ACCOUNT: student-01-xxxxxxxxxxxx@qwiklabs.net To set the active account, run: $ gcloud config set account `ACCOUNT`
  1. (Optional) You can list the project ID with this command:
gcloud config list project

Output:

[core] project = <project_ID>

Example output:

[core] project = qwiklabs-gcp-44776a13dea667a6 Note: For full documentation of gcloud, in Google Cloud, refer to the gcloud CLI overview guide.

Overview

In this lab, you will learn how to deploy a static website using Nginx on Google Cloud Run. You'll build a Docker image, store it in Artifact Registry, and then deploy it to Cloud Run, making your website accessible via a public URL.

Task 1. Set up your Environment

Configure your Google Cloud environment by setting the project ID, region and enabling necessary services.

  1. Set your Project ID is:
gcloud config set project {{{ project_0.project_id | "PROJECT_ID" }}} Note:
This command sets your active project.
  1. Set your default region to
gcloud config set run/region {{{ project_0.default_region | "REGION" }}} Note:
This command sets your default cloud run region.
  1. Enable the Cloud Run and Artifact Registry APIs.
gcloud services enable run.googleapis.com artifactregistry.googleapis.com Note:
This command enables the required Google Cloud services.

Task 2. Create a Static Website

Create a simple HTML file that will be served by Nginx.

  1. Create an index.html file with the following content:
cat > index.html <<EOF <!DOCTYPE html> <html> <head> <title>My Static Website</title> </head> <body> <div>Welcome to My Static Website!</div> <p>This website is served from Google Cloud Run using Nginx and Artifact Registry.</p> </body> </html> EOF Note:
This command creates the index.html file.

Task 3. Create an Nginx Configuration

Create an Nginx configuration file to serve the static website.

  1. Create a nginx.conf file with the following content:
cat > nginx.conf <<EOF events {} http { server { listen 8080; root /usr/share/nginx/html; index index.html index.htm; location / { try_files \$uri \$uri/ =404; } } } EOF Note:
This command creates the nginx.conf file.

Task 4. Create a Dockerfile

Create a Dockerfile to build an image with Nginx and your static website.

  1. Create a Dockerfile with the following content:
cat > Dockerfile <<EOF FROM nginx:latest COPY index.html /usr/share/nginx/html/ COPY nginx.conf /etc/nginx/nginx.conf EXPOSE 8080 CMD ["nginx", "-g", "daemon off;"] EOF Note:
This command creates the Dockerfile.

Task 5. Build and Push the Docker Image to Artifact Registry

Build the Docker image and push it to Artifact Registry.

  1. Create an Artifact Registry repository named nginx-static-site in the region you configured.
gcloud artifacts repositories create nginx-static-site \ --repository-format=docker \ --location={{{ project_0.default_region | "REGION" }}} \ --description="Docker repository for static website" Note:
This command creates the Artifact Registry repository.
  1. Build the Docker image.
docker build -t nginx-static-site . Note:
This command builds the Docker image.
  1. Tag the Docker image with the Artifact Registry repository URL.
docker tag nginx-static-site {{{ project_0.default_region | "REGION" }}}-docker.pkg.dev/{{{ project_0.project_id | "PROJECT_ID" }}}/nginx-static-site/nginx-static-site Note:
This command tags the Docker image.
  1. Push the Docker image to Artifact Registry.
docker push {{{ project_0.default_region | "REGION" }}}-docker.pkg.dev/{{{ project_0.project_id | "PROJECT_ID" }}}/nginx-static-site/nginx-static-site Note:
Ensure Docker is authenticated with gcloud. Run `gcloud auth configure-docker` if you have issues pushing the image.

Task 6. Deploy to Cloud Run

Deploy the Docker image from Artifact Registry to Cloud Run.

  1. Deploy the image to Cloud Run, allowing unauthenticated invocations.
gcloud run deploy nginx-static-site \ --image {{{ project_0.default_region | "REGION" }}}-docker.pkg.dev/{{{ project_0.project_id | "PROJECT_ID" }}}/nginx-static-site/nginx-static-site \ --platform managed \ --region {{{ project_0.default_region | "REGION" }}} \ --allow-unauthenticated Note:
This command deploys the image to Cloud Run and allows unauthenticated access.
  1. Retrieve the Cloud Run service URL.
gcloud run services describe nginx-static-site --platform managed --region {{{ project_0.default_region | "REGION" }}} --format='value(status.url)' Note:
This will print the public URL of your deployed static site.

Task 7. Verify the Deployment

Access the provided URL to verify your deployment. You should see your static website.

  1. Open the URL provided by the gcloud run services describe command in your web browser.
Note:
You should see the 'Welcome to My Static Website!' message.

Congratulations!

Congratulations! You have successfully deployed a static website using Nginx on Google Cloud Run, leveraging Artifact Registry for image storage. You can now customize your website, update the Docker image, and redeploy to Cloud Run to update your site.

Additional Resources

Manual Last Updated Jun 23, 2025

Lab Last Tested Jun 23, 2025

시작하기 전에

  1. 실습에서는 정해진 기간 동안 Google Cloud 프로젝트와 리소스를 만듭니다.
  2. 실습에는 시간 제한이 있으며 일시중지 기능이 없습니다. 실습을 종료하면 처음부터 다시 시작해야 합니다.
  3. 화면 왼쪽 상단에서 실습 시작을 클릭하여 시작합니다.

시크릿 브라우징 사용

  1. 실습에 입력한 사용자 이름과 비밀번호를 복사합니다.
  2. 비공개 모드에서 콘솔 열기를 클릭합니다.

콘솔에 로그인

    실습 사용자 인증 정보를 사용하여
  1. 로그인합니다. 다른 사용자 인증 정보를 사용하면 오류가 발생하거나 요금이 부과될 수 있습니다.
  2. 약관에 동의하고 리소스 복구 페이지를 건너뜁니다.
  3. 실습을 완료했거나 다시 시작하려고 하는 경우가 아니면 실습 종료를 클릭하지 마세요. 이 버튼을 클릭하면 작업 내용이 지워지고 프로젝트가 삭제됩니다.

현재 이 콘텐츠를 이용할 수 없습니다

이용할 수 있게 되면 이메일로 알려드리겠습니다.

감사합니다

이용할 수 있게 되면 이메일로 알려드리겠습니다.

한 번에 실습 1개만 가능

모든 기존 실습을 종료하고 이 실습을 시작할지 확인하세요.

시크릿 브라우징을 사용하여 실습 실행하기

이 실습을 실행하는 가장 좋은 방법은 시크릿 모드 또는 시크릿 브라우저 창을 사용하는 것입니다. 개인 계정과 학생 계정 간의 충돌로 개인 계정에 추가 요금이 발생하는 일을 방지해 줍니다.