이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Gemini Code Assist를 사용한 테스트 소개

1. 소개

이 실습에서는 Google Cloud의 AI 기반 공동작업 도구인 Gemini Code Assist를 사용하여 기존 Python 웹 애플리케이션에 테스트를 추가하고 테스트에서 노출된 해당 애플리케이션의 오류를 찾아 수정합니다. 그런 다음 Code Assist를 사용하여 새 기능에 대한 테스트를 만들고 이러한 테스트를 통과하고 앱을 확장하는 코드를 생성합니다.

실습할 내용…

Cloud Shell 편집기를 사용하여 기존 웹 애플리케이션의 코드를 다운로드합니다.
Cloud Shell 편집기의 Gemini Code Assist Chat을 사용하여 Google Cloud에 대한 일반적인 질문을 합니다.
Cloud Shell 편집기에서 Gemini Code Assist Inline 코드 지원을 사용하여 애플리케이션 테스트를 생성하고, 테스트를 실행하고, 오류를 찾아 수정한 후 애플리케이션의 기능을 확장합니다.

학습할 내용…

테스트 생성 및 코드 생성과 같은 여러 개발자 작업에 Gemini Code Assist를 사용하는 방법
Gemini Code Assist를 사용하여 Google Cloud에 대해 알아보는 방법을 알아봅니다.

필요한 항목…

Chrome 웹브라우저
Gmail 계정
결제가 사용 설정된 Cloud 프로젝트
Cloud 프로젝트에 Gemini Code Assist가 사용 설정됨

이 실습은 초보자를 포함한 모든 수준의 개발자를 대상으로 합니다. 샘플 애플리케이션은 Python 언어로 작성되어 있지만 Python 프로그래밍에 익숙하지 않아도 내용을 이해할 수 있습니다. 여기서는 개발자를 위한 Gemini Code Assist의 기능에 익숙해지는 데 중점을 두겠습니다.

2. 설정

이 실습에서 사용하려면 결제가 사용 설정된 Cloud 프로젝트가 이미 있어야 합니다. 이제 Google Cloud 프로젝트에서 Gemini API를 사용 설정합니다. 아래 단계를 따르세요.

https://console.cloud.google.com에서 이 실습을 위해 사용할 Google Cloud 프로젝트를 선택했는지 확인합니다. 오른쪽 상단에 있는 Gemini 아이콘을 클릭합니다.

콘솔 오른쪽에 Cloud용 Gemini 콘솔 창이 열립니다. 아래와 같이 사용 설정 버튼을 클릭합니다. 사용 설정 버튼이 표시되지 않고 대신 Chat 인터페이스가 표시되면 프로젝트에 이미 Cloud용 Gemini를 사용 설정한 것이므로 다음 단계로 바로 이동할 수 있습니다.

사용 설정되면 Gemini에 한두 개의 질문을 요청하여 테스트할 수 있습니다. 몇 가지 샘플 쿼리가 표시되지만 Cloud Run이란 무엇인가요?

Code Assist에서 질문에 대한 답변을 드립니다. 오른쪽 상단에 있는 아이콘을 클릭하면 Code Assist 채팅 창을 닫을 수 있습니다.

Cloud Shell 편집기의 Gemini 사용 설정

Gemini Code Assist를 사용할 수 있으며 널리 사용되는 여러 IDE에서 유사하게 동작합니다. 이 Codelab에서는 전적으로 웹브라우저에서 실행되는 Google Cloud Shell 편집기를 사용합니다. Cloud Shell 편집기에서 Gemini를 사용 설정하고 구성해야 하며 단계는 아래와 같습니다.

아래 표시된 아이콘을 통해 Cloud Shell을 실행합니다. Cloud Shell 인스턴스를 시작하는 데 1~2분 정도 걸릴 수 있습니다.

편집기 또는 편집기 열기 버튼 (경우에 따라)을 클릭하고 Cloud Shell 편집기가 표시될 때까지 기다립니다. 새 편집기 사용해 보기 버튼이 표시되면 클릭합니다.

그림과 같이 하단 상태 표시줄에서 Cloud Code - 로그인 버튼을 클릭합니다. 안내에 따라 플러그인을 승인합니다. 상태 표시줄에 'Cloud Code - 프로젝트 없음'이 표시되면 이를 선택한 다음 작업하려는 프로젝트 목록에서 특정 Google Cloud 프로젝트를 선택합니다.

오른쪽 하단의 상태 표시줄에 Gemini 아이콘이 표시되지 않으면 Cloud Code에서 Gemini 아이콘을 사용 설정해야 합니다. 그 전에 Cloud Code 확장 프로그램 → 설정으로 이동하여 IDE에서 Gemini (이전 명칭: 개발자용 Duet AI)가 사용 설정되어 있는지 확인한 후 아래와 같이 Duet AI: 사용 설정 텍스트를 입력합니다. 체크박스가 선택되어 있는지 확인합니다. IDE를 새로고침해야 합니다. 그러면 Cloud Code의 Gemini가 사용 설정되고 IDE에 Gemini 상태 표시줄이 표시됩니다.

그림과 같이 오른쪽 하단에 있는 Gemini 버튼을 클릭하고, Cloud AI Companion API가 사용 설정된 올바른 Google Cloud 프로젝트를 선택합니다.

Google Cloud 프로젝트를 선택한 후 상태 표시줄의 Cloud Code 상태 메시지에서 아래와 같이 오른쪽에 Gemini가 사용 설정되어 있는지 확인합니다.

이제 Gemini Code Assist를 사용할 수 있습니다.

3. 애플리케이션 다운로드 및 검사

터미널 창에서 명령어를 실행하여 시작 코드가 있는 저장소를 클론한 다음 새 디렉터리로 변경합니다 (터미널 창이 더 이상 열려 있지 않으면 터미널 또는 터미널 열기 버튼을 클릭하여 복원합니다).

git clone https://github.com/GoogleCloudPlatform/testing-with-duet-ai-codelab.git
cd testing-with-duet-ai-codelab

편집기에서 main.py를 열고 편집기 왼쪽에 있는 Gemini 채팅 아이콘을 클릭하여 Gemini Chat 창을 엽니다. 이 Gemini Chat 창은 IDE 내에 있으며, IDE의 코드를 토론 컨텍스트로 사용할 수 있습니다. 설명 프롬프트를 입력하고 답변을 확인합니다.

이 채팅 창을 스크롤하면 전체 답변을 확인할 수 있습니다. 설명에는 터미널 창에서 python3 main.py 명령어를 사용하여 이 프로그램을 로컬에서 실행할 수 있다고 나와 있습니다.

4. 로컬에서 실행

필요한 경우 cd ~/testing-with-duet-ai-codelab를 사용하여 저장소 디렉터리로 변경하고 터미널 창에 python3 main.py 명령어를 입력합니다.

http://127.0.0.1:8080 링크를 클릭하여 애플리케이션 홈페이지로 연결되는 새 브라우저 탭을 엽니다.

애플리케이션이 '로컬에서' 실행 중입니다. 사실 Cloud Shell 편집기는 약간의 마법을 부렸습니다. 애플리케이션이 사용자의 컴퓨터가 아닌 Cloud Shell에서 실행됩니다. 링크를 클릭하면 실제 로컬 주소인 http://127.0.0.1:8080이 아닌 Cloud Shell에서 이 용도로 설정한 프록시 서버로 연결되는 탭이 열립니다. 효과는 실제로 로컬에서 실행했을 때와 동일합니다.

지금 바꿔 보세요. 25를 입력하고 Convert!를

맞습니다. 25는 로마 숫자로 XXV입니다. 이제 여기서 끝내야 합니다.

숫자를 더 확인해 보세요. 25는 효과가 있었고, 24는요?

어쩌면 모든 것이 괜찮다고 생각하기 위해 약간 성급하게 생각했을 것입니다. 24에 대한 올바른 변환은 XXIIII인가요? XXIV여야 하지 않나요?

'XXIIII'이 맞다고 주장할 수 있지만, 실제로 사람들이 일반적으로 기대하는 것은 아닙니다. 하지만 실제로 틀린 것은 아니기 때문에 (많은 시계가 4를 로마 숫자 IIII로 표시함) 이 문제는 향후 개선을 위해 남겨 둡니다.

음수를 시도해 보면 어떨까요? 0? 이 숫자를 로마 숫자로 나타낼 수 있는 방법은 없습니다. 사용자에게 다시 표시되는 것이 없으며 이는 해결해야 할 오류인 것으로 보입니다.

테스트는 오류를 찾아 제거하는 데 도움이 될 수 있으며, Gemini Code Assist는 테스트를 작성하고 사용하는 데 도움이 됩니다.

5. 테스트 추가

Gemini Chat 창으로 돌아가 질문합니다.

How can I test the number_to_roman function?

응답을 검토합니다. 여기에는 unittest 모듈 및 pytest 모듈에 대한 설명이 포함됩니다.

Gemini Code Assist가 실제로 테스트를 작성하도록 할 수 있습니다. 실제 변환 코드가 있는 calendar.py를 열고 편집기에서 Gemini Chat 창으로 돌아가서 다시 질문합니다.

How can I test the number_to_roman function?

이제 새 파일에 복사하거나 삽입할 수 있는 unittest 모듈도 포함하여 응답이 더 구체적입니다.

import unittest
import calendar

class NumberToRomanTest(unittest.TestCase):

    def test_convert_1(self):
        self.assertEqual(calendar.number_to_roman(1), "I")

    def test_convert_4(self):
        self.assertEqual(calendar.number_to_roman(4), "IV")

    def test_convert_9(self):
        self.assertEqual(calendar.number_to_roman(9), "IX")

    def test_convert_40(self):
        self.assertEqual(calendar.number_to_roman(40), "XL")

    def test_convert_90(self):
        self.assertEqual(calendar.number_to_roman(90), "XC")

    def test_convert_400(self):
        self.assertEqual(calendar.number_to_roman(400), "CD")

    def test_convert_900(self):
        self.assertEqual(calendar.number_to_roman(900), "CM")

    def test_convert_1990(self):
        self.assertEqual(calendar.number_to_roman(1990), "MCMXC")

    def test_convert_2023(self):
        self.assertEqual(calendar.number_to_roman(2023), "MMXXIII")

위 예와 다른 코드가 표시될 수 있습니다. Gemini Code Assist의 기본 모델은 때때로 업데이트되므로 답변이 항상 동일하지는 않습니다. 다른 코드 세트가 표시되는 경우 이제 여기에 표시된 코드를 복사하여 이 Codelab에 표시된 샘플로 계속 진행할지, 아니면 Gemini Code Assist가 제공하는 대체 답변을 사용해 볼 수 있습니다. 시간이 있다면 두 가지 방법을 모두 시도해 볼 수도 있습니다. Gemini Code Assist는 필요에 따라 사용할 수 있는 코딩 어시스턴트입니다.

Gemini Chat 창 오른쪽 상단의 이중 화살표를 클릭하여 단위 테스트 코드가 포함된 새 파일을 만들거나 IDE를 사용하여 새 파일을 만들고 이 실습에 표시된 코드를 붙여넣습니다. 해당 창에서 Ctrl-S 또는 CMD-S를 눌러 저장하고 저장된 파일 calendar-unittest.py를 호출합니다.

터미널로 돌아가 Ctrl+C를 눌러 이전에 실행했던 웹 서버를 중지하고 셸 프롬프트를 표시합니다. 명령어 입력

python3 calendar-unittest.py

새 테스트를 실행합니다.

출력이 없습니다. 예상한 대로는 아니었어요. 모든 것이 조용히 통과했나요? 확실히 알고 싶으실 텐데요. 테스트 코드가 포함된 Gemini Code Assist의 답변을 다시 살펴보세요. 코드 아래에는 테스트 사례를 실행하는 방법에 관한 자세한 정보가 있습니다.

권장 명령어를 실행해 보세요.

python -m unittest discover

컴퓨터에서 python3 명령어의 별칭을 python로 지정하지 않으면 문제가 발생할 수 있습니다. 이 경우 다음을 실행하세요.

python3 -m unittest discover

명령어가 실행되지만 Ran 0 tests in 0.000s이 반환됩니다. 모듈에는 여러 테스트가 있습니다. 어떤 상황인가요?

명령어의 마지막 단어인 discover입니다. 어디에서 왔는가? Gemini Code Assist는 테스트 코드가 discover 또는 discover.py 파일에 저장될 것으로 예상했으나 그렇게 해야 한다고 지정하지 않았습니다. 실제로 calendar-unittest.py에 파일을 저장했으므로 다음 명령어를 실행해 봅니다.

python3 -m unittest calendar-unittest

이제 다음과 같이 많은 출력이 표시됩니다.

$ python3 -m unittest calendar-unittest
.F.FFFFFF
======================================================================
FAIL: test_convert_1990 (calendar-unittest.NumberToRomanTest)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "/home/charles_engelke/testing-with-duet-ai-codelab/calendar-unittest.py", line 28, in test_convert_1990
    self.assertEqual(calendar.number_to_roman(1990), "MCMXC")
AssertionError: 'MDCCCCLXXXX' != 'MCMXC'
- MDCCCCLXXXX
+ MCMXC

첫 번째 줄에는 통과한 각 테스트의 마침표와 실패한 각 테스트의 F가 표시됩니다. 대부분의 테스트가 실패합니다. 그런 다음 실패한 테스트를 개별적으로 나열하여 예상 출력과 실제 출력을 보여줍니다. 이러한 테스트가 어떤 순서로 실행되었는지는 다소 불분명합니다. 이는 파일에 테스트가 표시되는 순서가 아니라 테스트 이름의 알파벳 순서입니다. 따라서 test_convert_1이 먼저 실행되고, test_convert_1990, test_convert_2023 등이 차례로 실행되었습니다. 1 및 2023의 테스트 사례가 유일하게 통과했습니다.

이 코드를 처음 시도했을 때 24가 XXIIII로 변환되었음을 확인했습니다. 이는 정확히 잘못된 것은 아니지만 IIII가 IV로 변환되는 일반적인 형식은 아닙니다. 실패한 테스트는 모두 비슷한 사례에 대한 것이었습니다. 이 문제가 처음 발견되었을 때 실험실에서는 "이 문제는 실제로 틀린 것은 아니기 때문에 (많은 시계가 4를 로마 숫자 IIII로 표시함) 향후 개선을 위해 이 문제를 남겨 놓았습니다."라고 말했습니다.

테스트 사례를 예상하도록 변경하고 '잘못됨틀린'을 수락할 수 있습니다. 응답하거나, '향후 개선'이 필요한 시점이 되었다는 점을 인정해야 합니다. 따라서 다음 단계는 테스트에서 예상하는 더 허용 가능한 답변을 제공하기 위해 Gemini Code Assist의 도움을 받아 코드를 수정하는 것입니다.

6. 코드 개선

더 일반적인 XXIV 대신 24의 XXIIII와 같은 응답이 '실제로 틀리지 않았다'고 간주했습니다. 향후 개선을 위해 연기되었습니다. 그 미래는 바로 지금입니다. '잘 틀리지 않음' 답변이 아직도 성가십니다

로마 숫자에서 반복되는 자릿수에 대한 첫 번째 규칙은 연속으로 4개의 동일한 숫자가 있을 때마다 숫자 중 하나로 대체되어야 하고 그 뒤에 다음 더 큰 숫자가 와야 한다는 것입니다. 따라서 XXIIII를 XXIV로 바꿔야 합니다. 마찬가지로 XXXX는 XL로 변경되어야 하고 CCCC는 CD가 되어야 합니다.

number_to_roman으로 반환되기 직전에 roman 변수의 값을 다음과 같이 변경하는 방법을 Gemini Code Assist에 물어봅니다.

If the final value of roman has IIII in it, that should be replaced by IV. Similarly XXXX should be replaced by XL, and CCCC should become CD. How can I make those changes?

마지막에 코드를 추가하는 것이 좋습니다.

편집기에서 해당 줄을 복사/붙여넣기하거나 입력한 후 어떻게 되는지 살펴봅니다.

Gemini Code Assist는 첫 번째 대체를 완료한 후 발생할 수 있는 케이스를 처리하기 위해 더 많은 줄을 추가했습니다. 예를 들어 19는 XVIIII로, 그리고 XVIV로, 그리고 마지막으로 올바른 XIX로 변환됩니다.

Gemini Code Assist에서 유용한 제안을 한 경우 Tab 키를 눌러 추천을 수락하고 파일을 저장한 후 웹 서버를 다시 실행합니다. 그렇지 않으면 여기 예시에 표시된 줄을 수동으로 추가하고 파일을 저장합니다. 1999년과 같이 터프한 전환을 시도해 보세요.

정답입니다.

이제 테스트를 다시 실행합니다. 모두 통과합니다!

웹 애플리케이션을 프로덕션으로 전환할 준비가 된 것 같습니다.

7. Cloud Run에 배포

Cloud Run은 인터넷에서 컨테이너화된 애플리케이션을 자동으로 실행합니다. Flash와 같은 일반적인 프레임워크를 사용하여 작성된 애플리케이션의 경우 gcloud run deploy 명령어를 사용하면 컨테이너를 배포하기 전에 자동으로 빌드할 수도 있습니다. 다음 명령어를 실행합니다.

gcloud run deploy

터미널에서 소스 코드의 위치를 묻는 메시지가 표시되면 Enter 키를 눌러 올바른 위치를 제안합니다. 마찬가지로 서비스 이름을 입력하라는 메시지가 표시되면 Enter 키를 눌러 추천 단어를 수락합니다.

gcloud에서 사용할 프로젝트를 확인할 수 없으므로 명령어가 실패할 수 있습니다. 이 경우 다음 명령어를 실행합니다.

gcloud config set core/project <project-id>

여기서 는 프로젝트 ID로 대체되며 이 ID는 이름과 동일할 수 있습니다. 그런 다음 gcloud run deploy 명령어를 다시 실행합니다.

명령어를 실행하면 특정 API가 필요하지만 아직 사용 설정되지 않았다는 메시지가 표시됩니다. 사용 설정하려면 y를 입력합니다.
리전을 선택하라는 메시지가 표시되면 편리한 리전을 선택합니다. us-central1에 해당하는 번호를 입력하는 것이 안전합니다.
메시지가 표시되면 Y를 입력하여 계속 진행합니다.
이 Cloud Run 서비스의 인증되지 않은 호출을 허용하는 것이 좋습니다. Cloud Run에서 사용하는 인증 옵션은 서비스를 호출하는 프로그램에서 사용하기에 적합합니다. 웹사이트이므로 인증을 사용하지 않습니다.

Google Cloud가 컨테이너를 빌드 및 배포하고 컨테이너로 트래픽을 라우팅하고 액세스 정책을 설정한 후 홈페이지 링크를 표시합니다.

해당 링크로 이동하여 애플리케이션에 액세스할 수 있습니다.

숫자를 입력하고 Enter 키를 누르세요.

뭐라고!?!

컴퓨터에서 제대로 작동했습니다. 이 과정이 완료되지 않은 이유는 무엇인가요?

알아보세요. Gemini Code Assist에 질문하세요.

Why am I getting an internal server error on cloud run?

Gemini Code Assist는 비슷한 내용의 로그 파일을 읽을 수 있습니다. 직접 기록하는 방법을 Gemini Code Assist에 물어보세요.

메시지가 표시되면 안내를 따라 SSH 키를 생성합니다. 빨간색 !! 다음과 같이 오류 표시기를 확인할 수 있습니다.

그 뒤에 여기로 오는 호출 스택에 관한 여러 줄의 세부정보가 뒤에 옵니다. 여기에는 다음과 같은 내용이 있습니다.

calendar.py 파일을 보면 바로 number_to_roman 함수가 있습니다. 그리고 그것이 기계에서 작동했기 때문에 옳다는 것을 알고 있습니다. Cloud Run에서 무엇이 다를 수 있을까요?

답은 까다롭습니다. number_to_roman 함수가 정의된 calendar.py 파일과 마찬가지로 Python3에는 calendar라는 표준 모듈이 포함되어 있습니다. 로컬 머신에서 Python이 calendar라는 모듈을 찾을 때 애플리케이션 디렉터리를 먼저 검색했습니다. Cloud Run의 Python이 먼저 표준 모듈을 찾아 가져왔지만 number_to_roman 함수를 찾지 못했습니다.

이러한 환경 차이는 항상 발생할 수 있습니다. 다행히 애플리케이션을 컨테이너화하면 애플리케이션 내부에 환경이 포함되므로 애플리케이션을 실행하는 곳 어디서나 동일한 동작이 발생할 수 있습니다. Cloud Run과 동일한 컨테이너화된 애플리케이션을 로컬에서 실행했다면 동일한 문제가 발생했습니다.

문제를 해결하세요. 로컬 캘린더 모듈의 이름을 표준 모듈 이름이 아닌 이름으로 변경해야 합니다. calendar.py 파일 이름을 my_calendar.py로 바꾼 다음 main.py 및 calendar-unittest.py의 import calendar 줄을 import my_calendar로 변경합니다. 마지막으로 다음 줄을

roman = calendar.number_to_roman(number)

roman = my_calendar.number_to_roman(number)

로컬에서 시도해 보고 테스트를 실행한 후 다시 배포합니다.

gcloud run deploy

이제 이 기능이 작동합니다.

이 URL을 공유하면 로마 숫자 변환 도구가 필요한 모든 사용자가 해당 URL을 사용할 수 있습니다.

8. 선택사항: 더 보기 좋게 만들기

애플리케이션이 잘 실행되고 있으며 웹의 모든 사용자가 액세스할 수 있습니다. 하지만 조금 평범해 보입니다. 모두에게 공개하기 전에 Gemini Code Assist에 디자인 개선을 요청해 보세요.

templates/index.html 파일을 엽니다. Gemini 채팅 창에서 다음과 같이 질문합니다.

Make this index.html file use material design.

이에 대한 응답으로, 현재 파일에 을(를) 추가하면 다음과 유사한 결과가 표시됩니다.

<!DOCTYPE html>
<html>
<head>
    <title>Roman Numerals</title>
    <link rel="stylesheet" href="https://code.getmdl.io/1.3.0/material.indigo-pink.min.css">   
    <script defer src="https://code.getmdl.io/1.3.0/material.min.js"></script>     
</head>
<body>
    <h1 class="mdl-typography--title">Roman Numerals</h1>
    <form action="/convert" method="post">
        <div class="mdl-textfield mdl-js-textfield">
            <input class="mdl-textfield__input" type="text" id="number" name="number" required />
            <label class="mdl-textfield__label" for="number">Enter a number:</label>
          </div>
          <button class="mdl-button mdl-js-button mdl-button--raised mdl-button--colored">
            Convert!
          </button>
    </form>
</body>
</html>

아이콘을 사용하여 추천 코드를 복사하고 index.html의 기존 콘텐츠 위에 붙여넣습니다. 터미널에서 python3 main.py를 실행하고 링크를 클릭하여 미리보기 창을 엽니다. 이제 페이지는 조금 덜 단순합니다.

원하는 경우 convert.html 파일에서 이 과정을 반복할 수 있습니다.

Gemini Code Assist는 상당한 CSS를 알고 있으며 다양한 방식으로 애플리케이션 페이지의 스타일을 지정하는 데 도움을 줄 수 있습니다. 이는 시작에 불과합니다.

이 애플리케이션을 공유하려면 Cloud Run에 다시 배포해야 합니다.

gcloud run deploy

로마 숫자로 변환해야 하는 사용자에게 URL을 전달할 수 있습니다.

9. 축하합니다.

축하합니다. Gemini Code Assist를 사용하여 애플리케이션에 테스트를 추가하고, 오류를 수정하고, 향상된 기능을 추가했습니다.

빌드한 애플리케이션의 사용을 마치면 Cloud 콘솔 대시보드에서 애플리케이션을 삭제하여 앞으로 요금이 청구되지 않도록 할 수 있습니다.