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

1. 소개

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

실습할 내용…

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

학습할 내용…

테스트 생성, 코드 생성과 같은 여러 개발자 작업에 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 아이콘을 클릭합니다.

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

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

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에서 사용 설정해야 합니다. 그 전에 Cloud Code 확장 프로그램 → 설정으로 이동하여 IDE에서 Gemini(이전 명칭: 개발자를 위한 Duet AI)가 사용 설정되어 있는지 확인한 후 아래와 같이 Duet AI: Enable(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 채팅 창을 엽니다. 이 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는 어떤가요?

모든 것이 괜찮다고 생각한 것이 너무 성급했나 봅니다. XXIIII가 24의 올바른 변환인가요? 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. 코드 개선

24에 대한 응답이 더 일반적인 XXIV 대신 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로 대체되며 이름과 동일할 수 있습니다. 그런 다음 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을 공유하면 로마 숫자 변환 도구가 필요한 모든 사용자가 내 도구를 사용할 수 있습니다.

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를 사용하여 애플리케이션에 테스트를 추가하고, 오류를 수정하고, 향상된 기능을 추가했습니다.

빌드한 애플리케이션을 다 사용한 후에는 클라우드 콘솔 대시보드에서 삭제하여 향후 청구될 수 있는 요금을 방지할 수 있습니다.