이 문서는 보관 처리된 문서입니다. 무료 체험판 기간은 2021년 9월 30일 종료되었습니다.

Anthos Service Mesh를 사용하여 Cloud Run for Anthos를 Anthos Fleet 구성요소로 설치하는 방법에 대한 자세한 내용은 GA 버전 문서를 참조하세요.

사용 가능한 버전

최신
보관 파일

시스템 패키지 사용

이 튜토리얼에서는 그래프 설명 입력 매개변수를 PNG 이미지 형식의 다이어그램으로 변환하는 커스텀 Cloud Run for Anthos 서비스를 빌드하는 방법을 보여줍니다. 이 튜토리얼은 Graphviz를 사용하며 서비스의 컨테이너 환경에 시스템 패키지로 설치됩니다. Graphviz는 명령줄 유틸리티를 통해 요청을 처리하는 데 사용됩니다.

목표

Dockerfile로 커스텀 컨테이너를 작성하고 빌드합니다.
Cloud Run for Anthos 서비스 작성, 빌드, 배포
Graphviz DOT 유틸리티를 사용하여 다이어그램을 생성합니다.
컬렉션을 사용하거나 직접 만든 DOT 구문 다이어그램을 게시하여 서비스를 테스트합니다.

비용

이 문서에서는 비용이 청구될 수 있는 다음과 같은 Google Cloud 구성요소를 사용합니다.

프로젝트 사용량을 기준으로 예상 비용을 산출하려면 가격 계산기를 사용하세요. Google Cloud를 처음 사용하는 사용자는 무료 체험판을 사용할 수 있습니다.

시작하기 전에

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector
Make sure that billing is enabled for your Google Cloud project.
Cloud Run for Anthos API 사용 설정
gcloud CLI를 설치하고 초기화합니다.
kubectl 구성요소를 설치합니다.
```
gcloud components install kubectl
```
구성요소를 업데이트합니다.
```
gcloud components update
```
curl을 설치하여 서비스를 사용해 봅니다.
Cloud Run for Anthos 설정의 안내에 따라 새 클러스터를 만듭니다.

gcloud 기본값 설정

Cloud Run for Anthos 서비스의 기본값으로 gcloud를 구성하려면 다음 안내를 따르세요.

기본 프로젝트를 설정합니다.
```
gcloud config set project PROJECT_ID
```
PROJECT_ID를 이 튜토리얼에서 사용하는 프로젝트의 이름으로 바꿉니다.
클러스터에 gcloud를 구성합니다.
```
gcloud config set run/platform gke
gcloud config set run/cluster CLUSTER-NAME
gcloud config set run/cluster_location REGION
```
다음과 같이 바꿉니다.
- CLUSTER-NAME을 클러스터에 사용한 이름으로 바꿉니다.
- REGION을 지원되는 클러스터 위치 중 원하는 위치로 바꿉니다.

코드 샘플 검색

사용할 코드 샘플을 검색하려면 다음 안내를 따르세요.

샘플 앱 저장소를 로컬 머신에 클론합니다.
Node.js
```
git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples.git
```
또는 zip 파일로 샘플을 다운로드하고 압축을 풀 수 있습니다.
Python
```
git clone https://github.com/GoogleCloudPlatform/python-docs-samples.git
```
또는 zip 파일로 샘플을 다운로드하고 압축을 풀 수 있습니다.
Go
```
git clone https://github.com/GoogleCloudPlatform/golang-samples.git
```
또는 zip 파일로 샘플을 다운로드하고 압축을 풀 수 있습니다.
자바
```
git clone https://github.com/GoogleCloudPlatform/java-docs-samples.git
```
또는 zip 파일로 샘플을 다운로드하고 압축을 풀 수 있습니다.

Cloud Run for Anthos 샘플 코드가 있는 디렉터리로 변경합니다.

Node.js

cd nodejs-docs-samples/run/system-package/

Python

cd python-docs-samples/run/system-package/

Go

cd golang-samples/run/system_package/

자바

cd java-docs-samples/run/system-package/

아키텍처 시각화

기본 아키텍처는 다음과 같습니다.

사용자에서 웹 서비스, graphviz dot 유틸리티로의 요청 흐름을 보여주는 다이어그램 — 다이어그램 출처는 DOT 설명을 참조하세요.

사용자가 Graphviz 유틸리티를 실행하는 Cloud Run for Anthos 서비스에 대해 HTTP 요청을 수행하여 요청을 이미지로 변환합니다. 이 이미지는 사용자에게 HTTP 응답으로 전송됩니다.

코드 이해하기

`Dockerfile`로 환경 구성 정의

Dockerfile은 서비스에서 사용할 언어 및 기본 운영 환경(예: Ubuntu)에 따라 다릅니다.

이 서비스를 사용하려면 기본적으로 하나 이상의 추가 시스템 패키지가 필요합니다.

편집기에서 Dockerfile을 엽니다.
Dockerfile RUN 문을 찾습니다. 이 문을 사용하면 임의의 셸 명령어를 실행하여 환경을 수정할 수 있습니다. Dockerfile이 여러 FROM 문을 찾아 식별할 수 있는 여러 단계로 이루어져 있는 경우 Dockerfile은 마지막 단계에 있습니다.

특정한 필수 패키지와 패키지를 설치하는 메커니즘은 컨테이너 내부에 선언된 운영체제에 따라 다릅니다.

운영체제 또는 기본 이미지에 대한 안내를 확인하려면 해당 탭을 클릭합니다.
Debian/Ubuntu

run/system_package/Dockerfile

GitHub에서 보기 의견 보내기
RUN apt-get update -y && apt-get install -y \ graphviz \ && apt-get clean
Alpine
Alpine을 사용하려면 글꼴 지원을 위한 또 다른 패키지가 필요합니다.

run/system-package/Dockerfile

GitHub에서 보기 의견 보내기
RUN apk --no-cache add graphviz ttf-ubuntu-font-family
컨테이너 이미지의 운영체제를 확인하려면 FROM 문 또는 기본 이미지와 연결된 README의 이름을 확인하세요. 예를 들어 node를 확장하는 경우에는 Docker Hub에서 문서와 상위 Dockerfile을 찾을 수 있습니다.
docker build를 로컬에서 또는 Cloud Build를 사용해 이미지를 빌드하여 맞춤설정을 테스트합니다.

수신 요청 처리

샘플 서비스는 수신 HTTP 요청의 매개변수를 사용하여 적절한 dot 유틸리티 명령어를 실행하는 시스템 호출을 호출합니다.

아래의 HTTP 핸들러에서 그래프 설명 입력 매개변수는 dot querystring 변수입니다.

그래프 설명에는 querystring에 사용할 URL 인코딩 문자가 포함될 수 있습니다.

Node.js

run/system-package/app.js

GitHub에서 보기 의견 보내기

app.get('/diagram.png', (req, res) => {
  try {
    const image = createDiagram(req.query.dot);
    res.setHeader('Content-Type', 'image/png');
    res.setHeader('Content-Length', image.length);
    res.setHeader('Cache-Control', 'public, max-age=86400');
    res.send(image);
  } catch (err) {
    console.error(`error: ${err.message}`);
    const errDetails = (err.stderr || err.message).toString();
    if (errDetails.includes('syntax')) {
      res.status(400).send(`Bad Request: ${err.message}`);
    } else {
      res.status(500).send('Internal Server Error');
    }
  }
});

Python

run/system-package/main.py

GitHub에서 보기 의견 보내기

@app.route("/diagram.png", methods=["GET"])
def index():
    """Takes an HTTP GET request with query param dot and
    returns a png with the rendered DOT diagram in a HTTP response.
    """
    try:
        image = create_diagram(request.args.get("dot"))
        response = make_response(image)
        response.headers.set("Content-Type", "image/png")
        return response

    except Exception as e:
        print(f"error: {e}")

        # If no graphviz definition or bad graphviz def, return 400
        if "syntax" in str(e):
            return f"Bad Request: {e}", 400

        return "Internal Server Error", 500

Go

run/system_package/graphviz.go

GitHub에서 보기 의견 보내기


// diagramHandler renders a diagram using HTTP request parameters and the dot command.
func diagramHandler(w http.ResponseWriter, r *http.Request) {
	if r.Method != http.MethodGet {
		log.Printf("method not allowed: %s", r.Method)
		http.Error(w, fmt.Sprintf("HTTP Method %s Not Allowed", r.Method), http.StatusMethodNotAllowed)
		return
	}

	q := r.URL.Query()
	dot := q.Get("dot")
	if dot == "" {
		log.Print("no graphviz definition provided")
		http.Error(w, "Bad Request", http.StatusBadRequest)
		return
	}

	// Cache header must be set before writing a response.
	w.Header().Set("Cache-Control", "public, max-age=86400")

	input := strings.NewReader(dot)
	if err := createDiagram(w, input); err != nil {
		log.Printf("createDiagram: %v", err)
		// Do not cache error responses.
		w.Header().Del("Cache-Control")
		if strings.Contains(err.Error(), "syntax") {
			http.Error(w, "Bad Request: DOT syntax error", http.StatusBadRequest)
		} else {
			http.Error(w, "Internal Server Error", http.StatusInternalServerError)
		}
	}
}

자바

run/system-package/src/main/java/com/example/cloudrun/App.java

GitHub에서 보기 의견 보내기

get(
    "/diagram.png",
    (req, res) -> {
      InputStream image = null;
      try {
        String dot = req.queryParams("dot");
        image = createDiagram(dot);
        res.header("Content-Type", "image/png");
        res.header("Content-Length", Integer.toString(image.available()));
        res.header("Cache-Control", "public, max-age=86400");
      } catch (Exception e) {
        if (e.getMessage().contains("syntax")) {
          res.status(400);
          return String.format("Bad Request: %s", e.getMessage());
        } else {
          res.status(500);
          return "Internal Server Error";
        }
      }
      return image;
    });

내부 서버 오류와 잘못된 사용자 입력을 구분해야 합니다. 오류 메시지에 사용자 입력 문제를 나타내는 문자열 syntax가 포함된 경우를 제외하고 이 샘플 서비스는 모든 dot 명령줄 오류에 대해 내부 서버 오류를 반환합니다.

다이어그램 생성

다이어그램 생성의 핵심 로직은 dot 명령줄 도구를 사용하여 그래프 설명 입력 매개변수를 PNG 이미지 형식의 다이어그램으로 처리합니다.

Node.js

run/system-package/app.js

GitHub에서 보기 의견 보내기

// Generate a diagram based on a graphviz DOT diagram description.
const createDiagram = dot => {
  if (!dot) {
    throw new Error('syntax: no graphviz definition provided');
  }

  // Adds a watermark to the dot graphic.
  const dotFlags = [
    '-Glabel="Made on Cloud Run"',
    '-Gfontsize=10',
    '-Glabeljust=right',
    '-Glabelloc=bottom',
    '-Gfontcolor=gray',
  ].join(' ');

  const image = execSync(`/usr/bin/dot ${dotFlags} -Tpng`, {
    input: dot,
  });
  return image;
};

Python

run/system-package/main.py

GitHub에서 보기 의견 보내기

def create_diagram(dot):
    """Generates a diagram based on a graphviz DOT diagram description.

    Args:
        dot: diagram description in graphviz DOT syntax

    Returns:
        A diagram in the PNG image format.
    """
    if not dot:
        raise Exception("syntax: no graphviz definition provided")

    dot_args = [  # These args add a watermark to the dot graphic.
        "-Glabel=Made on Cloud Run",
        "-Gfontsize=10",
        "-Glabeljust=right",
        "-Glabelloc=bottom",
        "-Gfontcolor=gray",
        "-Tpng",
    ]

    # Uses local `dot` binary from Graphviz:
    # https://graphviz.gitlab.io
    image = subprocess.run(
        ["dot"] + dot_args, input=dot.encode("utf-8"), stdout=subprocess.PIPE
    ).stdout

    if not image:
        raise Exception("syntax: bad graphviz definition provided")
    return image

Go

run/system_package/graphviz.go

GitHub에서 보기 의견 보내기


// createDiagram generates a diagram image from the provided io.Reader written to the io.Writer.
func createDiagram(w io.Writer, r io.Reader) error {
	stderr := new(bytes.Buffer)
	args := []string{
		"-Glabel=Made on Cloud Run",
		"-Gfontsize=10",
		"-Glabeljust=right",
		"-Glabelloc=bottom",
		"-Gfontcolor=gray",
		"-Tpng",
	}
	cmd := exec.Command("/usr/bin/dot", args...)
	cmd.Stdin = r
	cmd.Stdout = w
	cmd.Stderr = stderr

	if err := cmd.Run(); err != nil {
		return fmt.Errorf("exec(%s) failed (%w): %s", cmd.Path, err, stderr.String())
	}

	return nil
}

자바

run/system-package/src/main/java/com/example/cloudrun/App.java

GitHub에서 보기 의견 보내기

// Generate a diagram based on a graphviz DOT diagram description.
public static InputStream createDiagram(String dot) {
  if (dot == null || dot.isEmpty()) {
    throw new NullPointerException("syntax: no graphviz definition provided");
  }
  // Adds a watermark to the dot graphic.
  List<String> args = new ArrayList<>();
  args.add("/usr/bin/dot");
  args.add("-Glabel=\"Made on Cloud Run\"");
  args.add("-Gfontsize=10");
  args.add("-Glabeljust=right");
  args.add("-Glabelloc=bottom");
  args.add("-Gfontcolor=gray");
  args.add("-Tpng");

  StringBuilder output = new StringBuilder();
  InputStream stdout = null;
  try {
    ProcessBuilder pb = new ProcessBuilder(args);
    Process process = pb.start();
    OutputStream stdin = process.getOutputStream();
    stdout = process.getInputStream();
    // The Graphviz dot program reads from stdin.
    Writer writer = new OutputStreamWriter(stdin, "UTF-8");
    writer.write(dot);
    writer.close();
    process.waitFor();
  } catch (Exception e) {
    System.out.println(e);
  }
  return stdout;
}

보안 서비스 설계

dot 도구의 모든 취약점은 웹 서비스의 잠재적 취약점입니다. 이를 완화하려면 정기적으로 컨테이너 이미지를 다시 빌드하여 graphviz 패키지의 최신 버전을 사용하면 됩니다.

현재 샘플을 확장하여 사용자 입력을 명령줄 매개변수로 허용하는 경우 명령어 삽입 공격으로부터 보호해야 합니다. 다음은 삽입 공격을 방지하는 몇 가지 방법입니다.

지원되는 매개변수 사전에 입력 매핑
입력이 알려진 안전한 값의 범위(예: 정규식 사용)와 일치하는지 여부 검사
셸 구문이 평가되지 않도록 입력 이스케이프 처리

코드 제공

코드를 제공하려면 Cloud Build로 빌드하고 Container Registry에 업로드한 후 Cloud Run for Anthos에 배포합니다.

다음 명령어를 실행하여 컨테이너를 빌드하고 Container Registry에 게시합니다.
Node.js
```
gcloud builds submit --tag gcr.io/PROJECT_ID/graphviz
```
여기서 PROJECT_ID는 GCP 프로젝트 ID이고 graphviz는 서비스에 지정할 이름입니다.

성공하면 ID, 생성 시간, 이미지 이름이 포함된 성공 메시지가 표시됩니다. 이미지는 Container Registry에 저장되며 원하는 경우 다시 사용할 수 있습니다.
Python
```
gcloud builds submit --tag gcr.io/PROJECT_ID/graphviz
```
여기서 PROJECT_ID는 GCP 프로젝트 ID이고 graphviz는 서비스에 지정할 이름입니다.

성공하면 ID, 생성 시간, 이미지 이름이 포함된 성공 메시지가 표시됩니다. 이미지는 Container Registry에 저장되며 원하는 경우 다시 사용할 수 있습니다.
Go
```
gcloud builds submit --tag gcr.io/PROJECT_ID/graphviz
```
여기서 PROJECT_ID는 GCP 프로젝트 ID이고 graphviz는 서비스에 지정할 이름입니다.

성공하면 ID, 생성 시간, 이미지 이름이 포함된 성공 메시지가 표시됩니다. 이미지는 Container Registry에 저장되며 원하는 경우 다시 사용할 수 있습니다.
자바
이 샘플은 Jib를 사용해서 일반적인 자바 도구로 Docker 이미지를 빌드합니다. Jib는 Dockerfile을 사용하거나 Docker를 설치할 필요 없이 컨테이너 빌드를 최적화합니다. Jib로 자바 컨테이너 빌드에 대해 자세히 알아보세요.
1. Dockerfile을 사용하여 시스템 패키지가 설치된 기본 이미지를 구성하고 빌드하여 Jib의 기본 이미지를 재정의합니다.
  
  run/system-package/Dockerfile
  
  GitHub에서 보기 의견 보내기
  # Use the Official eclipse-temurin image for a lean production stage of our multi-stage build. # https://hub.docker.com/_/eclipse-temurin/ FROM eclipse-temurin:17.0.8_7-jre RUN apt-get update -y && apt-get install -y \ graphviz \ && apt-get clean
  gcloud builds submit --tag gcr.io/PROJECT_ID/graphviz-base
  여기서 PROJECT_ID는 GCP 프로젝트 ID입니다.
2. Jib로 최종 컨테이너를 빌드하고 Container Registry에 게시합니다.
  
  run/system-package/pom.xml
  
  GitHub에서 보기 의견 보내기
  <plugin> <groupId>com.google.cloud.tools</groupId> <artifactId>jib-maven-plugin</artifactId> <version>3.3.2</version> <configuration> <from> <image>gcr.io/PROJECT_ID/graphviz-base</image> </from> <to> <image>gcr.io/PROJECT_ID/graphviz</image> </to> </configuration> </plugin>
  mvn compile jib:build \ -Dimage=gcr.io/PROJECT_ID/graphviz \ -Djib.from.image=gcr.io/PROJECT_ID/graphviz-base
  여기서 PROJECT_ID는 GCP 프로젝트 ID입니다.
다음 명령어를 사용하여 배포합니다.
```
gcloud run deploy graphviz-web --create-if-missing --image gcr.io/PROJECT_ID/graphviz
```
여기서 PROJECT_ID는 GCP 프로젝트 ID이고, graphviz는 위의 컨테이너 이름이고, graphviz-web은 서비스 이름입니다.

배포가 완료될 때까지 기다립니다. 이 작업은 30초 정도 걸릴 수 있습니다.
서비스에 코드 업데이트를 배포하려면 이전 단계를 반복합니다. 서비스에 배포할 때마다 새 버전이 생성되고 준비가 되면 자동으로 트래픽 제공이 시작됩니다.

사용해 보기

요청 페이로드에 DOT 구문 설명과 함께 HTTP POST 요청을 보내 서비스를 사용해 보세요.

서비스에 HTTP 요청을 보냅니다.

웹페이지에 다이어그램을 삽입할 수 있습니다.
1. Istio 인그레스 게이트웨이의 외부 IP를 가져오려면 다음 안내를 따르세요.
```
kubectl get svc istio-ingress -n gke-system
```
  여기서 결과 출력은 다음과 같이 표시됩니다.
```
NAME            TYPE           CLUSTER-IP     EXTERNAL-IP  PORT(S)
istio-ingress   LoadBalancer   XX.XX.XXX.XX   pending      80:32380/TCP,443:32390/TCP,32400:32400/TCP
```
  부하 분산기의 EXTERNAL-IP는 반드시 사용해야 하는 IP 주소입니다.
2. URL에서 이 EXTERNAL-IP 주소를 사용하여 curl 명령어를 실행합니다. 프로토콜(예: http://)은 SERVICE_DOMAIN에 포함하지 않습니다.
```
curl -G -H "Host: SERVICE_DOMAIN" http://EXTERNAL-IP/diagram.png \
   --data-urlencode "dot=digraph Run { rankdir=LR Code -> Build -> Deploy -> Run }" \
   > diagram.png
```
PNG 파일을 지원하는 모든 애플리케이션(예: Chrome)에서 결과 diagram.png 파일을 엽니다.

예를 들면 다음과 같습니다.

출처: DOT 설명

바로 활용할 수 있는 다이어그램 설명의 몇 가지 모음을 살펴볼 수 있습니다.

선택한 .dot 파일의 콘텐츠를 복사합니다.

curl 명령어에 붙여넣습니다.

curl -G -H "Host: SERVICE_DOMAIN" http://EXTERNAL-IP/diagram.png \
--data-urlencode "dot=digraph Run { rankdir=LR Code -> Build -> Deploy -> Run }" \
> diagram.png

삭제

이 튜토리얼용으로 새 프로젝트를 만든 경우 이 프로젝트를 삭제합니다. 기존 프로젝트를 사용한 경우 이 튜토리얼에 추가된 변경사항은 제외하고 보존하려면 튜토리얼용으로 만든 리소스를 삭제합니다.

프로젝트 삭제

비용이 청구되지 않도록 하는 가장 쉬운 방법은 튜토리얼에서 만든 프로젝트를 삭제하는 것입니다.

프로젝트를 삭제하려면 다음 안내를 따르세요.

주의: 프로젝트를 삭제하면 다음과 같은 효과가 발생합니다.

프로젝트의 모든 항목이 삭제됩니다. 이 문서의 태스크에 기존 프로젝트를 사용한 경우 프로젝트를 삭제하면 프로젝트에서 수행한 다른 작업도 삭제됩니다.
커스텀 프로젝트 ID가 손실됩니다. 이 프로젝트를 만들 때 앞으로 사용할 커스텀 프로젝트 ID를 만들었을 수 있습니다. appspot.com URL과 같이 프로젝트 ID를 사용하는 URL을 보존하려면 전체 프로젝트를 삭제하는 대신 프로젝트 내에서 선택한 리소스만 삭제합니다.

여러 아키텍처, 튜토리얼, 빠른 시작을 살펴보려는 경우 프로젝트를 재사용하면 프로젝트 할당량 한도 초과를 방지할 수 있습니다.

In the Google Cloud console, go to the Manage resources page.
Go to Manage resources
In the project list, select the project that you want to delete, and then click Delete.
In the dialog, type the project ID, and then click Shut down to delete the project.

튜토리얼 리소스 삭제

이 튜토리얼에서 배포한 Cloud Run for Anthos 서비스를 삭제합니다.
```
gcloud run services delete SERVICE-NAME
```
여기서 SERVICE-NAME은 선택한 서비스 이름입니다.

Google Cloud 콘솔에서 Cloud Run for Anthos 서비스를 삭제할 수도 있습니다.

Cloud Run for Anthos로 이동

튜토리얼 설정 중에 추가한 gcloud 기본 구성을 삭제합니다.

 gcloud config unset run/platform
 gcloud config unset run/cluster
 gcloud config unset run/cluster_location

프로젝트 구성을 삭제합니다.
```
 gcloud config unset project
```
이 튜토리얼에서 만든 다른 Google Cloud 리소스를 삭제합니다.
- Container Registry에서 가져온 gcr.io/<var>PROJECT_ID</var>/graphviz라는 컨테이너 이미지를 삭제합니다.
- 이 튜토리얼용 클러스터를 만든 경우 클러스터를 삭제합니다.

다음 단계

graphviz 앱에서 다음을 실험해보세요.
- 다이어그램 생성에 다양한 알고리즘을 적용하는 다른 graphviz 유틸리티에 대한 지원을 추가합니다.
- Cloud Storage에 다이어그램을 저장합니다. 이미지 또는 DOT 구문을 저장하시겠어요?
- Cloud Natural Language API로 콘텐츠 악용을 방지합니다.
- 이미지 처리에서 시스템 패키지의 다른 예시를 참조하세요.
Google Cloud에 대한 참조 아키텍처, 다이어그램, 권장사항 살펴보기 Cloud 아키텍처 센터 살펴보기

시스템 패키지 사용

목표

비용

시작하기 전에

gcloud 기본값 설정

코드 샘플 검색

Node.js

Python

Go

자바

Node.js

Python

Go

자바

아키텍처 시각화

코드 이해하기

Dockerfile로 환경 구성 정의

수신 요청 처리

Node.js

Python

Go

자바

다이어그램 생성

Node.js

Python

Go

자바

보안 서비스 설계

코드 제공

Node.js

Python

Go

자바

사용해 보기

삭제

프로젝트 삭제

튜토리얼 리소스 삭제

다음 단계

`Dockerfile`로 환경 구성 정의