IBM watsonx Code Assistant User Guide를 사용한 Red Hat Ansible Lightspeed

프로세스

1. Ansible Lightspeed 포털에 조직 관리자로 로그인합니다.
2. Log in in with Red Hat 을 클릭합니다.

3. Red Hat 계정 사용자 이름과 암호를 입력합니다. Ansible Lightspeed 서비스는 인증을 위해 Red Hat Single Sign-On(RH-SSO)을 사용합니다.

   인증 프로세스의 일부로 Ansible Lightspeed 서비스는 조직에 활성 Ansible Automation Platform 서브스크립션이 있는지 확인합니다. 인증에 성공하면 사용자 이름 및 할당된 사용자 역할과 함께 로그인 화면이 표시됩니다.

4. 로그인 화면에서 관리 포털 을 클릭합니다.

   Red Hat Ansible Lightspeed를 IBM watsonx Code Assistant 관리자 포털로 리디렉션하여 Red Hat Ansible Lightspeed를 IBM watsonx Code Assistant 인스턴스에 연결할 수 있습니다.

프로세스

1. Ansible Lightspeed 포털에 조직 관리자로 로그인합니다.
2. 로그인 화면에서 관리 포털 을 클릭합니다.

3. IBM watsonx Code Assistant 인스턴스의 API 키를 지정합니다.

   1. IBM Cloud API 키 에서 API 키 추가 를 클릭합니다. API 키를 입력할 화면이 표시됩니다.
   2. API 키를 입력합니다.
   3. 선택 사항: 테스트를 클릭하여 API 키의 유효성을 검사합니다.
   4. 저장을 클릭합니다.

4. 사용하려는 모델의 모델 ID를 지정합니다.

   1. 모델 설정을 클릭합니다.
   2. 모델 ID 에서 모델 ID 추가 를 클릭합니다. 모델 ID에 입력하기 위한 화면이 표시됩니다.
   3. 이전 절차에서 얻은 모델 ID 를 조직의 기본 모델로 입력합니다.
   4. 선택 사항: 테스트 모델 ID 를 클릭하여 모델 ID의 유효성을 검사합니다.

   5. 저장을 클릭합니다.

      API 키 및 모델 ID를 성공적으로 검증하면 Red Hat Ansible Lightspeed가 IBM watsonx Code Assistant 인스턴스에 연결됩니다.

프로세스

1. Red Hat OpenShift Container Platform에 관리자로 로그인합니다.

2. 네임스페이스를 생성합니다.

   1. 관리 → 네임스페이스로 이동합니다.
   2. 네임스페이스 생성을 클릭합니다.
   3. 네임스페이스의 고유 이름을 입력합니다.
   4. 생성을 클릭합니다.

3. Operator를 설치합니다.

   1. Operators → OperatorHub 로 이동합니다.
   2. Red Hat Ansible Automation Platform Operator를 설치할 네임스페이스를 선택합니다.
   3. Ansible Automation Platform Operator를 검색합니다.
   4. 검색 결과에서 Ansible Automation Platform (Red Hat에서 제공) 타일을 선택합니다.
   5. 업데이트 채널을 선택합니다. stable-2.x 또는 stable-2.x-cluster-scoped 를 채널로 선택할 수 있습니다.
   6. 업데이트 채널로 "stable-2.x"를 선택한 경우 대상 네임스페이스를 선택합니다.
   7. 설치를 선택합니다. Operator를 설치하는 데 몇 분이 걸립니다.
4. View Operator 를 클릭하여 새로 설치된 Red Hat Ansible Automation Platform Operator에 대한 세부 정보를 확인합니다.

프로세스

1. Red Hat OpenShift Container Platform으로 이동합니다.
2. 워크로드 시크릿 → 을 선택합니다.
3. 키/값 시크릿+생성 을 클릭합니다.
4. 프로젝트 목록에서 Red Hat Ansible Automation Platform Operator를 설치할 때 생성한 네임스페이스를 선택합니다.
5. 키/값 시크릿+생성 을 클릭합니다.
6. 시크릿 이름에 시크릿 의 고유 이름을 입력합니다. 예를 들면 model-aiconnect 입니다.

7. 다음 키와 관련 값을 개별적으로 추가합니다.

   Expand

   키	현재의
   사용자 이름	온프레미스 배포 전용 데이터 배포를 위해 IBM Cloud Pak에 연결하는 데 사용하는 사용자 이름을 입력합니다.
   model_type	IBM watsonx Code Assistant 모델에 따라 다음 값 중 하나를 입력합니다. 온프레미스 배포의 경우 (IBM Cloud Pak for Data): wca-onprem 클라우드 배포의 경우(IBM 클라우드): wca
   model_url	IBM watsonx Code Assistant 모델의 URL을 입력합니다.
   model_api_key	모델 설치 중에 생성된 IBM watsonx Code Assistant 모델의 API 키를 입력합니다.
   model_id	IBM watsonx Code Assistant 모델의 ID를 입력합니다.
   model_verify_ssl	Ansible Automation Platform 2.5에서만 지원됨 이 키는 IBM watsonx Code Assistant 모델의 SSL 인증서가 검증되었는지 여부를 제어합니다. default = true
   model_enable_anonymization	Ansible Automation Platform 2.5.250730 이상에서 선택적 및 지원됨 이 키는 개인 식별 정보(PII)를 익명화할 수 있는지 여부를 제어합니다. PII 정보에는 암호, IP 주소, 이메일 주소 및 기타 민감한 데이터가 포함됩니다. PII 익명화을 사용하면 사용자의 개인정보가 일부 일반 값으로 수정되어 데이터를 보호하고 데이터 유출 위험을 줄일 수 있습니다. 사용자가 입력한 모든 원본 정보를 유지하고 응답 품질을 개선하려는 경우 값을 false로 지정하여 익명화을 해제할 수 있습니다. 값을 false 로 설정하고 Ansible 관리자가 하이브리드 모드에서 Ansible Lightspeed를 사용하는 경우(이 모델은 IBM Cloud의 IBM watsonx Code Assistant에 있음) 사용자의 PII가 IBM Cloud로 전송됩니다. default = true

   Show more
   중요

   실수로 값 필드에 공백 문자(extra line, space 등)를 추가하지 않아야 합니다. 시크릿에 추가 또는 잘못된 문자가 있는 경우 IBM watsonx Code Assistant에 대한 연결이 실패합니다.

8. 생성을 클릭합니다.

프로세스

1. Red Hat OpenShift Container Platform으로 이동합니다.
2. Operator 설치된 Operator를 선택합니다.
3. 설치된 Operator 목록에서 Ansible Automation Platform Operator를 선택합니다.
4. Ansible Automation Platform 사용자 정의 리소스를 찾아 선택한 다음 필요한 앱을 클릭합니다.
5. YAML 탭을 선택합니다.

6. 텍스트를 스크롤하여 Lightspeed 카테고리를 찾고 spec: 섹션 아래에 다음 세부 정보를 추가합니다.

   spec:
     lightspeed:
       disabled: false
       model_config_secret_name: <Name of the model configuration secret that you recently created.>

   Copy to Clipboard Toggle word wrap
7. 저장을 클릭합니다. Ansible Lightspeed 서비스를 설정하는 데 몇 분이 걸립니다.

프로세스

1. Ansible Lightspeed 인스턴스의 URL을 가져옵니다.

   1. Red Hat OpenShift Container Platform에서 Networking → Routes 를 선택하고 생성된 Red Hat Ansible Lightspeed 인스턴스를 찾습니다.

   2. Location 열에서 Ansible Lightspeed 인스턴스의 URL을 복사합니다.

      URL 형식은 https://<lightspeed_route>/complete/aap/입니다.

2. VS Code 애플리케이션을 엽니다.
3. 활동 표시줄에서 확장 아이콘을 클릭합니다.
4. Installed Extensions 목록에서 Ansible 을 선택합니다.
5. Ansible 확장 페이지에서 설정 아이콘( )을 클릭하고 확장 설정을 선택합니다.

6. Ansible Lightspeed 설정을 선택하고 다음 정보를 지정합니다.

   • Ansible Lightspeed URL 필드에 온프레미스 배포의 경로 URL 을 입력합니다. Ansible 사용자에게는 Ansible Automation Platform 컨트롤러 인증 정보가 있어야 합니다.

   • 선택 사항: 기본 모델 대신 사용자 지정 모델을 사용하려면 모델 ID 덮어쓰기 필드에 사용자 지정 모델 ID를 입력합니다. 설정이 VS Code에 자동으로 저장됩니다.

     Red Hat Ansible Lightspeed 온프레미스 배포에 연결하도록 Ansible VS Code 확장을 구성한 후 Ansible VS Code 확장을 통해 Ansible Lightspeed에 로그인 해야 합니다.

     참고

     최근 Red Hat Ansible Automation Platform을 구독한 경우 Red Hat Ansible Lightspeed가 새 서브스크립션을 감지하는 데 몇 시간이 걸릴 수 있습니다. VS Code의 활동 표시줄에서 Ansible 확장에 있는 새로 고침 버튼을 사용하여 다시 확인합니다.

프로세스

1. Red Hat OpenShift Container Platform으로 이동합니다.
2. Operator 설치된 Operator를 선택합니다.
3. 설치된 Operator 목록에서 Ansible Automation Platform Operator를 선택합니다.
4. Ansible Automation Platform 사용자 정의 리소스를 찾아 선택한 다음 필요한 앱을 클릭합니다.
5. YAML 탭을 선택합니다.

6. 텍스트를 스크롤하여 Lightspeed 카테고리 아래의 spec 섹션을 찾습니다. 예를 들면 다음과 같습니다.

   spec:
     lightspeed:
       disabled: false
       model_config_secret_name: <Name of the model configuration secret that you recently created.>

   Copy to Clipboard Toggle word wrap
7. model_config_secret_name 값을 연결하려는 IBM watsonx Code Assistant의 이름으로 바꿉니다.

8. 저장을 클릭합니다.

   새로운 Ansible Lightspeed Pod가 생성됩니다. 새 Pod가 성공적으로 실행되면 이전 Ansible Lightspeed Pod가 종료됩니다.

프로세스

1. 시스템 감사자 사용자를 생성합니다.

   1. Red Hat Ansible Automation Platform에서 시스템 감사자 역할을 사용하여 사용자를 생성합니다. 이 절차는 Ansible Automation Platform 시작하기 의 사용자 생성 섹션을 참조하십시오.
   2. 온프레미스 배포를 위해 Ansible Lightspeed 포털(https://<lightspeed_route>/)에 새로 생성된 시스템 감사 사용자로 로그인할 수 있는지 확인한 다음 로그아웃합니다.

2. 시스템 감사자 의 토큰을 생성합니다.

   1. 온프레미스 배포를 위한 Ansible Lightspeed 포털(https://<lightspeed_route>/admin)에 다음 인증 정보를 사용하여 관리자로 로그인합니다.

      • 사용자 이름: admin
      • 암호: Red Hat Ansible Lightspeed가 배포된 Red Hat OpenShift Container Platform 클러스터 네임스페이스에서 < lightspeed-custom-resource-name>-admin-password 로 이름이 지정된 시크릿입니다.
   2. Django 관리 창의 사용자 영역에서 사용자를 선택합니다. 사용자 목록이 표시됩니다.
   3. 시스템 감사자 역할이 있는 사용자가 사용자 목록에 나열되어 있는지 확인합니다.
   4. Django Oauth 툴킷 영역에서 액세스 토큰 → 추가 를 선택합니다.

   5. 다음 정보를 제공하고 저장을 클릭합니다.

      • 사용자: 돋보기 아이콘을 사용하여 시스템 감사자 역할이 있는 사용자를 검색하고 선택합니다.
      • 토큰: 사용자의 토큰을 지정합니다. 나중에 사용할 수 있도록 이 토큰을 복사합니다.
      • ID 토큰: 토큰 ID를 선택합니다.
      • 애플리케이션: VS Code용 Ansible Lightspeed를 선택합니다.
      • expires: 토큰 만료 를 원하는 날짜 및 시간을 선택합니다.

      • scope: 범위를 읽기 쓰기 로 지정합니다.

        시스템 감사자 역할이 있는 사용자에 대한 액세스 토큰이 생성됩니다.

   6. 온프레미스 배포를 위한 Ansible Lightspeed 포털에서 로그아웃합니다.
3. 시스템 감사자 역할과 함께 사용자의 권한 부여 토큰을 사용하여 지표 https://<lightspeed_route>/metrics 에 액세스하여 Red Hat Ansible Lightspeed 온-프레미스 배포를 모니터링합니다.

프로세스

1. REST API 액세스 권한을 부여하려는 플랫폼 사용자를 선택합니다.

   Red Hat Ansible Automation Platform에서 기존 사용자를 선택하거나 플랫폼 사용자를 생성할 수 있습니다. 이 절차는 Ansible Automation Platform 시작하기 의 사용자 생성 섹션을 참조하십시오.

2. 온프레미스 배포를 위해 Ansible Lightspeed 포털(https://<lightspeed_route>/)에 사용자가 선택하거나 생성한 플랫폼 사용자로 로그인할 수 있는지 확인한 다음 로그아웃합니다.

3. 플랫폼 사용자의 토큰을 생성합니다.

   1. 온프레미스 배포를 위한 Ansible Lightspeed 포털(https://<lightspeed_route>/admin)에 다음 인증 정보를 사용하여 관리자로 로그인합니다.

      • 사용자 이름: admin
      • 암호: Red Hat Ansible Lightspeed가 배포된 Red Hat OpenShift Container Platform 클러스터 네임스페이스에서 < lightspeed-custom-resource-name>-admin-password 로 이름이 지정된 시크릿입니다.
   2. Django 관리 창의 사용자 영역에서 사용자를 선택합니다. 사용자 목록이 표시됩니다.
   3. 플랫폼 사용자가 사용자 목록에 나열되어 있는지 확인합니다.
   4. Django Oauth 툴킷 영역에서 액세스 토큰 → 추가 를 선택합니다.

   5. 다음 정보를 제공하고 저장을 클릭합니다.

      • 사용자: 돋보기 아이콘을 사용하여 API 액세스 권한을 부여하려는 사용자 또는 새로 생성된 사용자 또는 기존 사용자를 검색하고 선택합니다.
      • 토큰: 사용자의 토큰을 지정합니다. 나중에 사용할 수 있도록 이 토큰을 복사합니다.
      • ID 토큰: 토큰 ID를 선택합니다.
      • 애플리케이션: VS Code용 Ansible Lightspeed를 선택합니다.
      • expires: 토큰 만료 를 원하는 날짜 및 시간을 선택합니다.

      • scope: 범위를 읽기 쓰기 로 지정합니다.

        사용자에 대한 액세스 토큰이 생성됩니다.

   6. 온프레미스 배포를 위한 Ansible Lightspeed 포털에서 로그아웃합니다.

4. 권한 부여 헤더에 새로 생성된 토큰을 지정하여 Ansible Lightspeed REST API를 직접 호출합니다.

   curl -H "Authorization: Bearer <token>"
   https://<lightspeed_route>/api/v1/me/

   Copy to Clipboard Toggle word wrap

프로세스

1. Ansible Lightspeed 포털 로그인 페이지로 이동합니다.
2. Log in in with Red Hat 을 클릭합니다.
3. Red Hat 계정 사용자 이름과 암호를 입력합니다.

프로세스

1. VS Code 애플리케이션을 엽니다.
2. 탐색 메뉴에서 확장 아이콘을 클릭합니다.
3. 검색 필드에 Ansible 을 입력합니다.
4. Ansible 을 선택하여 Red Hat에서 게시한 Ansible 언어 지원 확장을 선택합니다.
5. 설치를 클릭합니다.

6. 설치가 완료되면 VSCode 설치를 확인합니다.

   1. .yml 또는 .yaml 파일 확장자를 사용하여 새 YAML 파일을 생성합니다.
   2. 상태 도구 모음에서 언어 표시기를 클릭하고 Ansible 을 선택하여 Ansible 언어 유형을 새 YAML 파일과 연결합니다.
   3. 테스트 플레이북 쓰기를 시작합니다. 콘텐츠 생성을 시작할 때 상황에 맞는 도움말이 표시됩니다.

프로세스

1. VS Code 애플리케이션을 엽니다.
2. 활동 표시줄에서 확장 아이콘 을 클릭합니다.
3. Installed Extensions 목록에서 Ansible 을 선택합니다.
4. Ansible 확장 페이지에서 설정 아이콘을 클릭하고 확장 설정을 선택합니다.

5. Ansible Lightspeed 설정을 선택하고 다음 정보를 지정합니다.

   1. Enable Ansible Lightspeed with watsonx Code Assistant inline suggestions 확인란이 선택되어 있는지 확인합니다.
   2. Ansible Lightspeed 필드의 URL 에서 다음 URL이 있는지 확인합니다. https://c.ai.ansible.redhat.com/.
   3. Enable Ansible Lightspeed with watsonx Code Assistant inline suggestions 확인란을 선택합니다.

6. 선택 사항: 기본 모델 대신 사용자 지정 모델을 사용하려면 모델 ID 덮어쓰기 필드에 사용자 지정 모델 ID를 입력합니다. model-override 설정을 사용하면 조직 관리자가 사용자 지정 모델을 생성하고 모델 ID를 별도로 공유한 후 기본 모델을 재정의하고 사용자 지정 모델을 사용할 수 있습니다.

   설정이 VS Code에 자동으로 저장됩니다.

프로세스

1. VS Code 애플리케이션을 엽니다.

2. Ansible Lightspeed 보기 또는 Accounts 메뉴에서 Connect 버튼을 사용하여 로그인합니다.

   • 연결 버튼을 사용하여 로그인:

     1. VS Code 활동 표시줄에서 Ansible 아이콘을 클릭합니다.
     2. Ansible Lightspeed 보기에서 연결을 클릭합니다.
     3. 화면의 프롬프트에 따라 Ansible Lightspeed에 로그인합니다.

   • 계정 메뉴를 사용하여 로그인합니다.

     1. VS Code 활동 표시줄에서 Accounts 메뉴를 클릭합니다.

     2. 제공된 로그인 옵션에 따라 Ansible을 사용하거나 Red Hat과 함께 로그인하려면 Ansible Lightspeed로 로그인합니다.

        참고
        • VS Code 확장 기능이 활성 상태이면 로그인 옵션이 표시됩니다. Ansible 측면 패널을 열거나 VS Code 편집기에서 Ansible 파일을 열면 확장 기능이 활성화됩니다. 이 옵션이 표시되지 않으면 연결 버튼을 사용하여 Ansible Lightspeed 서비스에 연결합니다.
        • 온프레미스 Red Hat OpenShift Dev Spaces와 같이 Ansible Lightspeed에서 알 수 없는 도메인에서 클라우드 개발 환경을 사용하는 경우 계정 로그인 메뉴에 Ansible을 사용하도록 Red Hat과 함께 로그인 옵션이 제공됩니다. 이 옵션은 장치 코드 흐름을 사용하여 로그인 프로세스를 성공적으로 완료하며 Red Hat 인증 확장 v0.2.0 이상이 필요합니다. 이 인증 흐름이 필요하지만 Ansible 옵션을 사용하기 위해 Red Hat의 로그인이 표시되지 않는 경우 Ansible VS Code 확장 v24.5.2 이상을 사용하고 있는지 확인하십시오.
     3. 화면의 프롬프트에 따라 Ansible Lightspeed에 로그인합니다.

   인증에 성공하면 사용자 이름 및 할당된 사용자 역할과 함께 로그인 화면이 표시됩니다.

프로세스

1. Red Hat 계정으로 VS Code에 로그인합니다.

2. 새 YAML 파일을 생성하거나 기존 YAML 파일을 사용합니다.

   • YAML 파일을 생성합니다.

     1. File → New text file을 선택합니다.
     2. 화면 오른쪽 하단에서 Plain text 를 클릭하고 언어 모드에서 Ansible 을 선택합니다.
     3. 파일을 YAML 파일 형식 확장자(.yml 또는 .yaml)로 저장합니다.

   • 기존 YAML 파일을 사용합니다.

     1. 화면 오른쪽 하단에서 기존 언어 모드를 클릭하고 언어 모드 설정에서 Ansible 을 선택합니다.

        참고

        VS Code 편집기에 언어 모드 섹션이 표시되지 않는 경우 명령 팔레트에서 언어 모드 Ansible구성 을 선택합니다.

3. VS Code 오른쪽 하단의 상태 표시줄에 Lightspeed 항목이 표시되는지 확인합니다.

   Ansible 이 이미 원하는 언어로 선택되었지만 Lightspeed 항목이 표시되지 않으면 Ansible 을 언어 모드로 다시 선택합니다. 다음 그림에서는 VS Code 상태 표시줄의 Lightspeed 및 Ansible 항목을 보여줍니다.

   그림 4.2. Ansible 및 Lightspeed를 선택한 언어 모드로 설정

   

4. 선택 사항: Ansible lint 누락에 대한 오류 메시지가 표시되면 누락된 모듈을 설치하거나 비활성화할 수 있습니다. 다음 작업 중 하나를 수행합니다.

   • Ansible lint 설치: 설치 정보는 Ansible Lint 설명서의 설치 섹션을 참조하십시오.

   • Ansible lint를 비활성화합니다.

     1. 활동 표시줄에서 확장 아이콘 을 클릭합니다.
     2. 설치된 확장 기능 목록에서 Ansible 을 선택합니다.
     3. Ansible 확장 페이지에서 설정 아이콘을 클릭하고 확장 설정을 선택합니다.
     4. Ansible 유효성 검사 > Lint: Enabled 확인란을 지웁니다.

5. 플레이북을 생성하거나 기존 플레이북을 사용합니다.

   자세한 내용은 플레이북 시작하기 가이드를 참조하십시오.

6. 플레이북에서 다음 정보를 제공하여 단일 작업에 대한 코드 권장 사항을 요청합니다.

   1. 올바른 들여쓰기에 - name: 로 새 행을 시작하여 새 Ansible 작업을 추가합니다.
   2. 동일한 줄에 작업 설명 후 name: 에 자세한 자연 언어 프롬프트를 추가합니다. 예를 들어 다음 단일 작업 프롬프트를 지정할 수 있습니다. - 이름: Install postgresql-server

   3. 작업 설명 후에 Enter 를 직접 누릅니다. 파일의 동일한 위치에 커서를 유지하고 코드 권장 결과가 입력될 때까지 기다립니다.

      Ansible Lightspeed 서비스가 참여하고 있으며 단일 작업에 대한 코드 권장 사항을 생성하기 시작합니다.

      중요

      Ansible Lightspeed 서비스는 코드 권장 사항을 채우는 데 작업당 약 5초가 걸립니다. 다중 작업 프롬프트를 사용하는 경우 Ansible Lightspeed 서비스는 결과를 채우는 데 시간이 다소 오래 걸립니다(작업 수의 시간 5초). 코드 권장 사항이 생성되는 동안 커서를 이동하거나 키를 누르지 마십시오. 커서 위치를 변경하거나 임의의 키를 누르면 Ansible VS Code 확장이 요청을 취소하고 Ansible Lightspeed 서비스에서 요청을 처리하지 않습니다.

      Ansible Lightspeed 서비스가 참여하면 Lightspeed 처리 상태 표시기가 화면 오른쪽 아래에 표시되어 코드 권장 사항이 생성됨을 나타냅니다.

      

7. 코드 권장 사항을 보고 권장 사항이 작업 의도와 일치하는지 확인합니다.

   다음 그림에서는 단일 작업 Install postgresql-server 에 대해 Ansible Lightspeed 서비스에서 생성한 코드 권장 사항을 보여줍니다.

   

8. 코드 권장 사항을 수락하거나 거부합니다.

   • 코드 권장 사항을 수락하려면 Tab 을 누릅니다.

   • 코드 권장 사항을 거부하려면 Esc 키를 누릅니다.

     참고

     권장 사항을 거부하면 프롬프트를 수정하고 생성된 코드 권장 사항을 다시 한 번 검토하여 작업 의도와 일치시킬 수 있습니다.

9. ANSIBLE: LIGHTSPEED TRAINING MATCHES 탭에서 콘텐츠 소스 일치 결과를 확인합니다.

   다음 그림에서는 작업 프롬프트 Install postgresql-server 의 기존 Ansible Galaxy 콘텐츠에 있는 교육 일치 항목을 보여줍니다.

   
10. 저장을 클릭하여 Ansible YAML 파일에 코드 권장 사항 변경 사항을 저장합니다.

프로세스

1. Red Hat 계정으로 VS Code에 로그인합니다.

2. 새 YAML 파일을 생성하거나 기존 YAML 파일을 사용합니다.

   • YAML 파일을 생성합니다.

     1. File → New text file을 선택합니다.
     2. 화면 오른쪽 하단에서 Plain text 를 클릭하고 언어 모드에서 Ansible 을 선택합니다.
     3. 파일을 YAML 파일 형식 확장자(.yml 또는 .yaml)로 저장합니다.

   • 기존 YAML 파일을 사용합니다.

     1. 화면 오른쪽 하단에서 기존 언어 모드를 클릭하고 언어 모드 설정에서 Ansible 을 선택합니다.

        참고

        VS Code 편집기에 언어 모드 섹션이 표시되지 않는 경우 명령 팔레트에서 언어 모드 Ansible구성 을 선택합니다.

3. VS Code 오른쪽 하단의 상태 표시줄에 Lightspeed 항목이 표시되는지 확인합니다.

   Ansible 이 이미 원하는 언어로 선택되었지만 Lightspeed 항목이 표시되지 않으면 Ansible 을 언어 모드로 다시 선택합니다. 다음 그림에서는 VS Code 상태 표시줄의 Lightspeed 항목을 보여줍니다.

   그림 4.3. Ansible 및 Lightspeed를 선택한 언어 모드로 설정

   

4. 선택 사항: Ansible lint 누락에 대한 오류 메시지가 표시되면 누락된 모듈을 설치하거나 비활성화할 수 있습니다. 다음 작업 중 하나를 수행합니다.

   • Ansible lint 설치: 설치 정보는 Ansible Lint 설명서의 설치 섹션을 참조하십시오.

   • Ansible lint를 비활성화합니다.

     1. 활동 표시줄에서 확장 아이콘 을 클릭합니다.
     2. 설치된 확장 기능 목록에서 Ansible 을 선택합니다.
     3. Ansible 확장 페이지에서 설정 아이콘을 클릭하고 확장 설정을 선택합니다.
     4. Ansible 유효성 검사 > Lint: Enabled 확인란을 지웁니다.

5. 플레이북을 생성하거나 기존 플레이북을 사용합니다.

   자세한 내용은 플레이북 시작하기 가이드를 참조하십시오.

6. 플레이북에서 다음 정보를 제공하여 다중 작업 코드 권장 사항을 요청합니다.

   1. 올바른 들여쓰기에 pound 기호(#)를 입력하여 새 YAML 파일 주석을 시작합니다.

   2. 앰퍼샌드 기호(&)를 사용하여 각 작업을 분리하여 시퀀스에 자세한 자연 언어 프롬프트를 추가합니다.

      다중 작업 프롬프트의 예

      # Install postgresql-server & run postgresql-setup command

      Copy to Clipboard Toggle word wrap

      가독성을 높이기 위해 다중 작업 인라인 프롬프트를 여러 줄로 분할합니다. 이를 위해 현재 행을 앰퍼샌드 기호(&)로 종료하고 다음 행을 해시 기호(#)로 시작합니다.

      여러 줄로 분할되는 다중 작업 프롬프트의 예

      # Create a keypair called lightspeed-keypair & create a vpc & create vpc_id var &
      # create a security group that allows SSH & create subnet with 10.0.1.0/24 cidr &
      # create an internet gateway & create a route table

      Copy to Clipboard Toggle word wrap

   3. 작업 설명 후에 Enter 를 직접 누릅니다. 파일의 동일한 위치에 커서를 유지하고 코드 권장 결과가 입력될 때까지 기다립니다.

      Ansible Lightspeed 서비스가 참여하고 있으며 여러 작업에 대한 코드 권장 사항을 생성하기 시작합니다.

      중요

      Ansible Lightspeed 서비스는 코드 권장 사항을 채우는 데 작업당 약 5초가 걸립니다. 다중 작업 프롬프트를 사용하는 경우 Ansible Lightspeed 서비스는 결과를 채우는 데 시간이 다소 오래 걸립니다(작업 수의 시간 5초). 코드 권장 사항이 생성되는 동안 커서를 이동하거나 키를 누르지 마십시오. 커서 위치를 변경하거나 임의의 키를 누르면 Ansible VS Code 확장이 요청을 취소하고 Ansible Lightspeed 서비스에서 요청을 처리하지 않습니다.

      Ansible Lightspeed 서비스가 참여하면 Lightspeed 처리 상태 표시기가 화면 오른쪽 아래에 표시되어 코드 권장 사항이 생성됨을 나타냅니다.

      

7. 선택 사항: 다중 작업 코드 권장 사항이 생성되지 않는 경우 VS Code에서 로그아웃한 후 Red Hat 계정을 사용하여 다시 로그인합니다.

8. 코드 권장 사항을 보고 권장 사항이 작업 의도와 일치하는지 확인합니다.

   다음 그림에서는 다중 작업 프롬프트 Install postgresql-server 및 run postgresql-setup 명령을 위해 Ansible Lightspeed 서비스에서 생성한 코드 권장 사항을 보여줍니다.

   

9. 코드 권장 사항을 수락하거나 거부합니다.

   • 코드 권장 사항을 수락하려면 Tab 을 누릅니다.

   • 코드 권장 사항을 거부하려면 Esc 키를 누릅니다.

     참고

     권장 사항을 거부하면 프롬프트를 수정하고 생성된 코드 권장 사항을 다시 한 번 검토하여 작업 의도와 일치시킬 수 있습니다.

10. ANSIBLE: LIGHTSPEED TRAINING MATCHES 탭에서 콘텐츠 소스 일치 결과를 확인합니다.

    다음 그림에서는 작업 프롬프트 multitask 프롬프트 Install postgresql-server & run postgresql-setup 명령 의 기존 Ansible Galaxy 콘텐츠에 있는 교육 일치 항목을 보여줍니다.

    
11. 저장을 클릭하여 Ansible YAML 파일에 코드 권장 사항 변경 사항을 저장합니다.

프로세스

1. Red Hat 계정으로 VS Code에 로그인합니다.
2. 활동 표시줄에서 Ansible 아이콘을 클릭합니다.

3. Ansible Creator 에서 시작하기 를 클릭합니다. Ansible Content Creator 페이지가 표시됩니다.

   다음 그림은 Ansible Content Creator 페이지를 표시합니다.

   그림 4.5. Ansible 플레이북을 생성하는 설정

   
4. Ansible Lightspeed 타일을 사용하여 플레이북을 선택합니다. 플레이북 생성 페이지가 표시됩니다.

5. Playbook 을 수행할 내용 필드에 플레이북을 생성할 프롬프트를 입력하고 분석을 클릭합니다.

   몇 초 후에 플레이북 의도에 권장되는 단계가 플레이북에 대해 제안된 단계를 검토하고 필요에 따라 수정합니다.

6. 다음 작업 중 하나를 수행합니다.

   • 단계의 의도와 일치하는 경우: 플레이북 생성을 클릭합니다.
   • 수정이 필요한 경우: 편집기를 클릭하고 의도에 맞게 작업 또는 단계를 업데이트합니다.
   • 작업 제안이 의도와 일치하지 않는 경우: 뒤로 이동하여 원래 프롬프트를 변경하고 처음부터 다시 시작합니다.
   • 원래 작업 제안을 복원하려면 재설정 을 클릭하고 다음 단계로 진행합니다.

7. 단계를 확인한 후 플레이북 생성을 클릭합니다.

   플레이북이 생성하는 데 몇 초가 걸리며, 사용자 필드에 대해 생성된 플레이북이 새로 생성된 플레이북을 표시합니다.

8. Open editor 를 클릭합니다. 생성된 플레이북이 VS Code 편집기에서 인타이틀먼트가 없는 YAML 파일로 열립니다.
9. 인타이틀먼트가 없는 YAML 파일을 저장합니다.

프로세스

1. Red Hat 계정으로 VS Code에 로그인합니다.
2. VS Code에서 Ansible 플레이북 YAML 파일을 엽니다.

3. 다음 방법 중 하나를 사용하여 플레이북 설명을 확인합니다.

   • 활성 플레이북 YAML 파일에서 다음을 수행합니다.

     1. 플레이북 파일 내의 아무 곳에나 커서를 배치합니다.
     2. Ansible Lightspeed를 마우스 오른쪽 버튼으로 클릭하고 플레이북 설명 을 선택합니다.

   • Ansible 패널에서 다음을 수행합니다.

     1. 탐색 메뉴에서 Ansible 아이콘을 클릭합니다.

     2. 현재 플레이북 설명 을 선택합니다.

        플레이북 설명은 VS Code 화면의 오른쪽 패널에 표시됩니다.

        다음 그림에서는 플레이북 설명의 예를 보여줍니다.

        그림 4.6. 플레이북 설명 예

        

프로세스

1. Red Hat 계정으로 VS Code에 로그인합니다.
2. 활동 표시줄에서 Ansible 아이콘을 클릭합니다.

3. 다음 방법 중 하나를 사용하여 역할을 생성합니다.

   • Ansible 패널에서 다음을 수행합니다.

     1. 탐색 메뉴에서 Ansible 아이콘을 클릭합니다.
     2. 역할 생성을 클릭합니다.

   • 개인 정보 보호 정책

     • VS Code 편집기의 명령행에서 View → Command lets를 클릭한 다음 > Ansible Lightspeed: Role generation 을 입력합니다.

       Ansible Lightspeed를 사용하여 역할 생성 페이지가 VS Code 화면의 오른쪽 패널에 표시됩니다.

4. 목록에서 역할을 생성할 컬렉션 선택에서 역할을 생성할 컬렉션을 선택합니다. 역할을 생성하려면 작업 공간 내에 컬렉션이 있어야 합니다.

   컬렉션이 없는 경우 다음 방법 중 하나를 사용하여 생성해야 합니다.

   • 다음 명령을 사용합니다.

     ansible-creator init 컬렉션 myns.mycollection my_directory

     명령을 실행한 후 VS Code로 새 디렉터리를 엽니다.

   • Ansible VS Code 확장 사용

     자세한 내용은 Ansible Automation Platform 시작하기 가이드의 콘텐츠 컬렉션 정보를 참조하십시오.

5. In the Describe what you want to achieve in natural language field, enter the prompts to create a role and then click Analyze.

   몇 초 후에 역할 의도에 권장되는 단계는 역할에 대해 제안된 단계를 검토하고 필요에 따라 수정합니다.

6. 다음 작업을 수행합니다.

   1. 역할 이름을 검토하고 선택적으로 변경합니다.
   2. 역할이 생성될 컬렉션을 검토합니다.

   3. 제안된 단계가 의도와 일치하는지 확인한 다음 Continue 를 클릭합니다.

      역할이 생성되는 데 몇 초가 걸리며, 새로 생성된 역할은 역할이 생성된 파일 목록과 함께 표시됩니다.

      참고
      • 단계를 수정하려면 편집기 필드를 클릭하고 의도에 맞게 프롬프트 또는 단계를 업데이트한 다음 Continue 를 클릭합니다.
      • 역할 제안이 의도와 일치하지 않는 경우: 뒤로 를 클릭하여 원래 프롬프트를 변경하고 처음부터 다시 시작합니다.
      • 원래의 제안된 단계로 복원하려면 재설정 을 클릭하고 계속 을 클릭하여 다음 단계로 진행합니다.
7. 파일 저장을 클릭합니다. 새 역할을 포함하는 파일 목록이 표시됩니다.
8. 파일을 클릭하여 VS Code 편집기에서 직접 엽니다.

프로세스

1. Red Hat 계정으로 VS Code에 로그인합니다.
2. VS Code의 역할 디렉터리에서 Ansible 역할 YAML 파일을 엽니다.

3. 다음 방법 중 하나를 사용하여 플레이북 설명을 확인합니다.

   • 활성 역할 YAML 파일에서 다음을 수행합니다.

     1. 플레이북 파일 내의 아무 곳에나 커서를 배치합니다.
     2. 마우스 오른쪽 버튼으로 클릭하고 Ansible Lightspeed를 사용하여 역할 설명을 선택합니다.

   • Ansible 패널에서 다음을 수행합니다.

     1. 탐색 메뉴에서 Ansible 아이콘을 클릭합니다.
     2. 현재 플레이북 설명 을 선택합니다.

   • 개인 정보 보호 정책

     • VS Code 편집기의 명령줄 편집기에서 Ansible Lightspeed를 사용하여 역할 설명을 입력합니다.

       VS Code 화면의 오른쪽 패널에 역할 설명이 표시됩니다.

       다음 그림에서는 역할 설명의 예를 보여줍니다.

       그림 4.7. 역할 설명의 예

       

프로세스

1. IBM watsonx Code Assistant Hybrid Cloud Console을 조직 관리자로 사용하여 Ansible Lightspeed 에 로그인합니다.

2. 탐색 패널에서 Ansible Lightspeed > 관리 대시보드 를 선택합니다.

   Admin 대시보드에는 기본적으로 지난 30일 동안의 분석 원격 분석 데이터의 그래픽 표현이 표시됩니다.

3. 다음 필터를 사용하여 Telemetry 데이터를 구체화합니다.

   • 특정 기간 또는 사용자 지정 날짜 범위의 Telemetry 데이터를 보려면 빠른 날짜 범위 목록에서 날짜 범위를 선택합니다.
   • 특정 IBM watsonx Code Assistant 모델에 대한 Telemetry 데이터를 보려면 모델 이름 목록에서 모델 ID를 선택합니다. 기본적으로 관리 대시보드에는 모든 모델에 대한 Telemetry 데이터가 표시됩니다.

프로세스

1. Ansible Lightspeed 포털에 조직 관리자로 로그인합니다.
2. 로그인 화면에서 관리 포털 을 클릭합니다.
3. 관리 포털에서 Telemetry 를 클릭합니다.

4. 관리 대시보드 Telemetry를 비활성화하려면 Operational Telemetry 데이터만 선택합니다.

   참고

   관리 대시보드 원격 분석을 다시 활성화하려면 관리 대시보드 원격 분석 데이터를 선택합니다.

5. 저장을 클릭합니다.

1. 콘텐츠 구문 분석 툴을 사용하여 교육 데이터 세트를 생성
2. IBM watsonx Code Assistant를 사용하여 사용자 지정 모델 생성 및 배포
3. 사용자 지정 모델을 사용하도록 Red Hat Ansible Lightspeed 구성

프로세스

1. GitHub에서 검사할 리포지토리로 이동합니다.
2. 리포지토리 .github 폴더에 ansible-code-bot .yml 이라는 .yml 구성 파일을 생성합니다.
   예를 들어 .github/ansible-code-bot.yml.

3. 구성 파일에서 interval 매개변수로 검사 일정을 지정합니다. interval 매개변수를 daily, weekly 또는 monthly 로 지정할 수 있습니다. 예를 들면 다음과 같습니다.

   schedule:
     interval: daily

   Copy to Clipboard Toggle word wrap
4. 변경 사항을 커밋합니다.

프로세스

1. Ansible 코드 봇 대시보드에 로그인합니다.

   Ansible 코드 봇 대시보드에는 코드 봇이 설치된 리포지토리 목록이 표시되고 검사 일정이 설정되지 않았거나 수동 또는 예약된 스캔으로 설정되어 있는지 여부를 나타냅니다.

2. 리포지토리 검사 기록을 보려면 리포지터리 옆에 있는 엘립 스 아이콘( )을 클릭하고 검사 기록 보기를 선택합니다.

   리포지토리의 검사 기록은 검사 시작 시간, 검사 상태, 검사 유형(스케줄 또는 수동), 생성된 경우 가져오기 요청에 대한 링크, 검사가 실패한 경우 로그 메시지와 함께 표시됩니다.

3. GitHub에서 리포지터리를 보려면 리포지터리 옆에 있는 엘립스 아이콘( )을 클릭하고 리포지토리 보기를 선택합니다.

프로세스

1. Ansible 코드 봇 대시보드에 로그인합니다.
2. GitHub에서 코드 관리를 클릭합니다.
3. GitHub에서 프로필 사진 > 설정을 클릭합니다.
4. Integrations 에서 Applications 를 클릭합니다.

5. 리포지토리 액세스 영역에서 다음 작업 중 하나를 수행합니다.

   • 새 리포지토리 추가: Select repositories 목록에서 추가할 리포지토리를 선택합니다. 새로 추가된 리포지토리는 Ansible 코드 봇 대시보드에 표시됩니다.
   • 기존 리포지토리 제거: 리포지토리 선택 목록에서 삭제하려는 리포지토리 옆에 있는 교차 아이콘을 클릭합니다. 삭제된 리포지토리 세부 정보는 Ansible 코드 봇 대시보드에 더 이상 표시되지 않습니다.
6. 저장을 클릭합니다.

프로세스

1. Red Hat OpenShift Container Platform으로 이동합니다.
2. Operator 설치된 Operator를 선택합니다.
3. 프로젝트 목록에서 Red Hat Ansible Automation Platform Operator를 설치할 때 생성한 네임스페이스를 선택합니다.
4. Ansible Automation Platform Operator를 찾아 선택합니다.
5. Ansible Automation Platform 사용자 정의 리소스를 찾아 선택한 다음 필요한 앱을 클릭합니다.
6. YAML 탭을 선택합니다. 편집기가 YAML 편집기 보기로 전환됩니다.

7. spec: 섹션을 스크롤하여 spec: 섹션 아래에 다음 매개변수를 추가합니다.

   extra_settings:
       - setting: ANSIBLE_AI_MODEL_MESH_API_VERIFY_SSL
         value: false

   Copy to Clipboard Toggle word wrap
8. 저장을 클릭합니다.

9. 자동화 컨트롤러 Pod를 다시 시작하여 수정된 YAML을 적용합니다.
   다음 단계를 수행합니다.

   1. Red Hat OpenShift Container Platform에서 워크로드 → 포드 를 선택합니다.
   2. 업데이트한 Ansible Lightspeed Pod를 찾아 선택합니다.
   3. Pod 옆에 있는 편집 아이콘을 클릭하고 Pod 삭제 를 선택합니다.
      선택한 Pod가 삭제되고 새 Pod가 생성됩니다.

1. Visual Studio Code를 엽니다.
2. File > Preferences > Settings 로 이동합니다.
3. 사이드바에서 Application → Proxy 를 선택합니다.

4. Cryo stat: 프록시 필드에서 다음 URL을 프록시에 추가합니다.

   • https://c.ai.ansible.redhat.com/
   • https://sso.redhat.com: RH-SSO를 사용하여 사용자를 인증하는 경우.
5. http: Proxy Support 드롭다운 목록에서 Override 를 선택합니다.

6. 다음 구성 키를 검색하고 선택합니다.

   • Eleak Fetch
   • 자체 CA(인증 기관)를 사용하는 경우 시스템 인증서 V2.

1. VS 코드 확장 네트워크 프록시 테스트를 설치합니다.

2. 네트워크 프록시 테스트: 테스트 연결 작업을 사용하여 서버와 엔드포인트를 대상으로 /check/status 엔드포인트 를 사용합니다.

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

   https://c.ai.ansible.redhat.com/check/status/ Red Hat Ansible Lightspeed 클라우드 서비스에 대한 연결을 테스트합니다.