정적 파일 제공

애플리케이션은 동적 요청 처리 외에도 자바스크립트, 이미지, CSS와 같은 정적 파일을 종종 제공해야 합니다. 가변형 환경의 앱은 Cloud Storage와 같은 Google Cloud 옵션의 정적 파일을 제공하거나, 직접 제공하거나, 타사 콘텐츠 전송 네트워크(CDN)를 사용할 수 있습니다.

Cloud Storage에서 파일 제공

Cloud Storage는 동적 웹 앱의 정적 애셋을 호스팅할 수 있습니다. 앱에서 직접 제공하는 대신 Cloud Storage를 사용할 때의 이점은 다음과 같습니다.

  • Cloud Storage가 콘텐츠 전송 네트워크 역할을 하게 되는데, 그렇다고 특별한 구성이 필요한 것은 아닙니다. 공개적으로 읽을 수 있는 모든 객체가 글로벌 Cloud Storage 네트워크에 캐시되기 때문입니다.
  • 정적 애셋 제공에 따른 부하를 Cloud Storage로 분산함으로써 앱 부하를 줄일 수 있습니다. 포함된 정적 애셋 수 및 액세스 빈도에 따라 앱 실행 비용을 크게 줄일 수 있습니다.
  • Cloud Storage를 사용하면 콘텐츠 액세스를 위한 대역폭 비용을 낮출 수 있습니다.

Cloud SDK 또는 Cloud Storage API를 사용하여 Cloud Storage에 애셋을 업로드할 수 있습니다.

Google Cloud 클라이언트 라이브러리는 App Engine 앱에서 Cloud Storage로 데이터를 저장하고 검색할 수 있는 Cloud Storage에 대한 관용적 자바 클라이언트를 제공합니다.

Cloud Storage 버킷을 사용한 파일 제공의 예시

다음의 짧은 예시에서는 Cloud Storage 버킷을 만들고 Cloud SDK를 사용하여 정적 애셋을 업로드 하는 방법을 보여줍니다.

  1. 버킷을 만듭니다. 버킷 이름을 프로젝트 ID와 동일하게 지정하는 것이 일반적이지만 필수는 아닙니다. 버킷 이름은 전역적으로 고유해야 합니다.

    gsutil mb gs://<your-bucket-name>
    
  2. 버킷에 있는 항목의 읽기 액세스 권한을 부여하도록 ACL을 설정합니다.

    gsutil defacl set public-read gs://<your-bucket-name>
    
  3. 버킷에 항목을 업로드합니다. 애셋을 업로드하고 업데이트할 때는 일반적으로 rsync 명령어가 가장 빠르고 쉬운 방법입니다. cp를 사용해도 됩니다.

    gsutil -m rsync -r ./static gs://<your-bucket-name>/static
    

이제 https://storage.googleapis.com/<your-bucket-name>/static/...을 통해 정적 애셋에 액세스할 수 있습니다.

커스텀 도메인 이름에서 제공하는 방법 등 Cloud Storage를 사용해서 정적 애셋을 제공하는 방법에 대한 자세한 내용은 정적 웹사이트를 호스팅하는 방법을 참조하세요.

다른 Google Cloud 서비스에서 파일 제공

Cloud CDN 또는 다른 Google Cloud Storage 서비스를 사용할 수도 있습니다.

앱에서 직접 파일 제공

앱에서 파일을 제공하는 방법은 간단하지만 몇 가지 단점이 있습니다.

  • 정적 파일에 대한 요청에서 동적 요청에 사용되어야 할 리소스가 사용될 수 있습니다.
  • 구성에 따라서는 응답 지연이 발생할 수 있으며 이로 인한 부하 처리가 새 인스턴스 생성에도 영향을 미칠 수 있습니다.

팁: 프로덕션 환경에서는 일반적으로 Google Cloud 또는 타사 CDN을 사용하여 앱과 별도로 정적 콘텐츠를 제공하는 것이 좋습니다.

앱을 사용한 정적 파일 제공 예

자바 런타임의 서블릿 컨테이너는 앱의 배포 설명자web.xml 파일을 사용하여 URL을 정적 애셋을 포함한 서블릿에 매핑합니다. web.xml을 지정하지 않으면 모든 항목이 기본 서블릿에 매핑되는 기본값이 사용됩니다.

이 예에서 ./src/main/webapp/index.html/stylesheets/styles.css에서 제공되는 스타일 시트를 나타냅니다.

<!doctype html>
<html>
<head>
<title>Static Files</title>
<link rel="stylesheet" type="text/css" href="/stylesheets/styles.css">
</head>
<body>
  <p>This is a static file serving example.</p>
</body>
</html>

styles.css 파일은 ./src/main/webapp/stylesheets/styles.css에 있습니다.

body {
  font-family: Verdana, Helvetica, sans-serif;
  background-color: #CCCCFF;
}

정적 파일이 web.xml 파일에서 처리되는 방법을 명시적으로 구성할 수 있습니다. 예를 들어, .jpg 확장자를 가진 모든 파일에 대한 요청을 매핑하는 방법은 다음과 같습니다.

<servlet-mapping>
    <servlet-name>default</servlet-name>
    <url-pattern>*.jpg</url-pattern>
</servlet-mapping>

Play와 같은 웹 프레임워크를 사용하는 경우에는 정적 애셋에 대한 프레임워크 문서를 참조해야 합니다.