Wazi Developer for VS Code 설치

다운로드하기 전에 IBM Z Open Editor 라이센스 계약 및 써드파티 주의사항을 검토하십시오.

설치의 전제조건:

• Visual Studio Code 버전 1.44 이상: Wazi Developer for VS Code는 독립형 IDE가 아니라 VS Code 확장 세트로 제공되므로 먼저 VS Code를 설치하고 구성해야 합니다. 사용 가능한 최신 VS Code 버전을 항상 사용하는 것이 좋습니다. 하지만, 필수 최소 버전이 1.44.0이더라도 IBM Z Open Editor에 영향을 줄 수 있는 VS Code 사용자 설정의 수정사항이 포함된 1.45.1 이상을 사용하도록 권장합니다. VS Code가 설치되어 있지 않은 경우 Microsoft에서 제공하는 Visual Studio Code for Java 설치 프로그램이 자동으로 Java SDK를 다운로드하여 VS Code와 함께 설치하므로 이 설치 프로그램을 사용하는 것이 좋습니다. (이 옵션을 사용하는 경우 Java 종속성에 대한 다음 글머리 기호를 건너뛰십시오.) VS Code의 설치 및 구성에 대한 정보는 해당 문서를 참조하십시오.

• Java SDK 버전 8 이상 - 64비트: 이 확장에 포함된 COBOL, PL/I 및 HLASM 언어 서버는 Java로 구현되었습니다. 따라서 이를 시작하려면 64비트 Java SDK를 설치하고 구성해야 합니다. 위에서 설명한 대로 VS Code for Java 설치를 권장하지만 VS Code를 이미 갖고 있거나 Java를 설치하려는 경우 다음 옵션에서 선택할 수 있습니다.

  • Oracle Java 8 또는 Oracle Java의 LTS 버전 11

  • OpenJDK의 버전 8, 11 또는 17 Z Open Editor의 버전 1.1 이상을 사용하는 경우 JRE(Java Runtime Environments)만 사용할 수도 있습니다.

  • 최신 버전의 Java도 작동해야 하지만 Z Open Editor에 대해 Java 8 및 11만큼 엄격하게 테스트되지는 않았습니다.

  이 확장이 Java를 사용하는 방식을 구성하는 데 대해 다양한 설정이 제공됩니다. 세부사항은 아래의 Java 구성 절을 참조하십시오. 특정 Java 버전에서 문제가 발생하는 경우에는 문의하십시오.

• (권장) Git: Git을 포함하는 기능을 사용하려면 Git을 설치하고 VS Code가 이를 표시할 수 있도록 시스템 경로에서 사용 가능하게 해야 합니다. Mac에서는 Git을 기본으로 제공합니다. Linux에서는 배포판의 패키지 관리자를 통해 Git을 설치할 수 있습니다. Windows의 경우 https://git-scm.com에서 Git을 확보할 수 있습니다.

• (권장) Zowe CLI 6.33.3 이상: Zowe를 사용하여 명령행을 통해 z/OS® MVS™ 또는 USS에서 직접 파일을 열고 편집하려면 Zowe CLI 및 호스트 컴포넌트가 구성되어야 합니다. 자세한 정보는 z/OS와 상호작용하기 위한 통합 설정을 참조하십시오.

메인프레임 DEV에서 설치 패키지를 다운로드하기 위한 프로시저에 따라 메인프레임 DEV에서 Wazi Developer for VS Code의 클라이언트를 다운로드하십시오. 시스템에 다운로드한 <license>_Wazi_Developer_for_VSCode_<version>.zip의 압축을 푸십시오.

다운로드한 2진 파일의 코드 서명을 확인하려는 경우에는 다음 프로시저를 참조하십시오. 아직 OpenSSL을 설치하지 않은 경우에는 이를 설치하십시오.

1. 위에서 압축을 푼 <license>_Wazi_Developer_for_VSCode_<version>.zip에는 2진 파일을 확인하는 데 사용되는 .sig 및 .pem 파일이 포함되어 있습니다.

2. 인증서 유효성을 확인하십시오.

   1. 인증서 세부사항을 보려면 다음 명령을 실행하십시오.

      $ openssl x509 -text -in wazi-certificate.pem -noout

   2. 공개 키 세부사항을 보려면 다음 명령을 실행하십시오.

      $ openssl rsa -noout -text -inform PEM -in wazi-public.pem -pubin

   3. 공개 키와 인증서의 지수를 비교하여 이 공개 키가 정말로 해당 인증서 내의 키인지 확인하십시오. Mac OS Preview 등의 다른 인증서 뷰어를 사용할 수도 있습니다.

   4. IBM 공용 인증서의 유효성을 확인하려면 다음 명령을 입력하십시오.

      $ openssl ocsp -no_nonce -issuer wazi-chain0.pem -cert wazi-certificate.pem -VAfile wazi-chain0.pem -text -url http://ocsp.digicert.com -respout ocsptest

      인증서가 유효한 경우 출력은 다음과 같습니다.

      Response verify OK

3. 다운로드한 2진 파일을 확인하십시오.

   서명 및 공개 키 파일을 사용하여 파일을 확인하려면 다음 명령을 실행하십시오.

   $ openssl dgst -sha256 -verify wazi-public.pem -signature ${binary-filename}.sig ${binary-filename}

   예를 들어, zopeneditor-1.0.0.vsix를 확인하려면 다음을 실행하십시오.

   $ openssl dgst -sha256 -verify wazi-public.pem -signature zopeneditor-1.0.0.vsix.sig zopeneditor-1.0.0.vsix

   바이너리 확인이 성공하는 경우 출력은 다음과 같습니다.

   Verified OK

IBM Z Open Editor에는 필수 소프트웨어로 Zowe Explorer VS Code 확장 1.19.0 이상이 필요합니다(1.20.0이 권장됨). IBM Z Open Editor를 설치하는 경우 이는 자동으로 VS Code Marketplace로부터 Zowe Explorer를 다운로드하려고 시도합니다. 오프라인으로 작업 중인 경우에는 먼저 wazi-development-client-<version>.zip의 압축을 풀어 얻은 Zowe Explorer VSIX 파일 Zowe.vscode-extension-for-zowe-<version>.vsix를 VS Code 인스턴스에 설치하십시오. .vsix 파일에서 설치하기 위한 VS Code 문서를 따를 수 있습니다.

IBM Z Open Editor는 IBM 엔터프라이즈 언어에 대한 지원을 제공합니다. IBM Z Open Editor는 다음 두 가지 접근법을 통해 설치할 수 있습니다.

언제든지 Mainframe DEV 또는 VS Code Marketplace로부터 최신 IBM Z Open Editor 버전을 얻을 수 있습니다. 기본적으로 VS Code는 확장 업데이트의 유무를 확인하고 이를 자동으로 설치합니다. 확장 자동 업데이트에 설명된 대로 자동 업데이트를 사용 안함으로 설정할 수 있습니다.

중요: IBM Z Open Editor를 설치하기 전에 개발 시스템에 전체 Java SDK가 설치되고 구성되어 있어야 합니다. 위의 전제조건 절과 IBM Z Open Editor에 대한 Java 구성 절을 참조하십시오.

참고: IBM Wazi Developer 1.1.0부터 사용자 빌드 기능은 IBM Z Open Editor VS Code 확장의 일부입니다. 사용자 빌드를 사용하면 z/OS 개발자가 IBM Dependency Based Build(DBB) 도구를 사용하여 Wazi Developer 내에서 개인 빌드를 실행할 수 있습니다. 자세히 알아보려면 사용자 빌드 문서를 따르십시오.

IBM Z Open Debug VS Code 확장을 z/OS Debugger와 함께 사용하여 원격 VS Code 클라이언트의 z/OS COBOL 및 PL/I 애플리케이션을 디버그할 수 있습니다.

wazi-development-client-<version>.zip의 압축을 풀어 얻은 다음 VS Code 확장을 VS Code 인스턴스(V1.43 이상)에 설치하십시오.

• zopendebug-<version>.vsix

• zopendebug-profileui-<version>.vsix

.vsix 파일에서 설치하기 위한 VS Code 문서를 따를 수 있습니다.

워크스테이션에서 IBM Z Open Debug를 업그레이드하려면 메인프레임 DEV에서 최신 wazi-development-client-<version>.zip을 다운로드하여 압축 파일의 압축을 풀고 .vsix 파일을 설치하십시오.