Kakao i Machine Learning 공공 클라우드 환경 CLI는 Kakao i Cloud (공공)의 사용자 액세스 키를 이용하여 로그인합니다.
공공 클라우드 환경에서 이용 가능한 CLI 명령어는 공공 환경 주의사항 문서를 참고하시기 바랍니다.

1. Kakao i Cloud (공공) 사전 작업

사용자 엑세스 키는 Kakao i Cloud (공공) 콘솔에서 프로젝트를 생성한 후에 만들 수 있습니다. 사용자 액세스 키를 발급하기 위해는 프로젝트를 선택해야 합니다. 프로젝트 생성 방법은 Kakao i Cloud console > 관리자 가이드 > 조직에 프로젝트 생성하기 문서를 참고하시기 바랍니다.

• 조직 소유자 또는 조직 관리자 역할을 가진 Kakao i Cloud (공공) 사용자만 프로젝트를 만들 수 있습니다.

2. 사용자 액세스 키 발급

Step 1. Kakao i Cloud (공공) 콘솔 로그인하기

Kakao i Cloud (공공) 콘솔( https://console.kakaoicloud-kr-gov.com/)에 로그인합니다.

• 조직 이름을 hpc-kiml으로 입력한 후, 아이디(이메일 주소)와 비밀번호 입력합니다.

Step 2. Kakao i Cloud (공공) 사용자 액세스 키 발급하기

사용자 액세스 키를 발급하는 자세한 방법은 Kakao i Cloud console > 설정 가이드를 참고하시기 바랍니다.

1. Kakao i Cloud (공공) 콘솔 우측 상단에 위치한 프로필 아이콘을 클릭 후, 설정 > 사용자 액세스 키를 클릭합니다.

2. 사용자 액세스 키 화면에서 [사용자 액세스 키를 생성해주세요.]를 클릭합니다.

3. 사용자 액세스 키 만들기 팝업창에서 액세스 키 발급에 필요한 정보를 입력한 후, [만들기] 버튼을 클릭해 사용자 액세스 키를 발급합니다.

   그림Kakao i Cloud (공공) 사용자 액세스 키 발급 화면

4. 사용자 액세스 키 만들기 팝업창에서 발급된 (1)사용자 액세스 키 ID와 (2)사용자 액세스 보안 키를 복사하여 보관합니다.

주의
Kakao i Cloud (공공) 사용자 액세스 보안 키는 발급 시점에만 조회가 가능합니다. 보안 키를 반드시 별도로 관리하시기 바랍니다.

• 보안 키를 분실한 경우, 새로운 사용자 액세스키를 발급하여 Kakao i Machine Learning 공공 클라우드 환경 콘솔에 로그인할 수 있습니다.

3. KiML CLI 설치 및 로그인

Step 3. pip 설치 및 최신 버전 점검

KiML CLI 패키지를 안전하게 설치하기 위해 Python 및 pip(package manager for python)가 최신 버전인지 점검합니다. pip 설치가 필요하거나 버전이 낮은 경우, pip install 명령어가 실행되지 않을 수 있습니다.

코드예제pip 설치 및 버전 업그레이드

pip install pip --upgrade
pip install setuptools --upgrade

Step 4. KiML CLI 설치하기

사용하는 운영체제(Mac,Linux 또는 Windows) 환경에 따라 Powershell 또는 Bash에서 pip install 명령어를 실행하여 KiML CLI를 설치합니다.

Mac 또는 Linux 환경

Bash 명령 프롬포트를 열고, pip 명령어를 이용하여 KiML CLI 패키지를 설치합니다.

코드예제KiML 패키지 설치(Mac 또는 Linux 환경)

pip install kiml --index-url https://pypi.ml.kakaoicloud-kr-gov.com/simple --trusted-host pypi.ml.kakaoicloud-kr-gov.com --force-reinstall

Windows 환경

1. 시작 메뉴 > Windows 시스템 폴더 > 실행에서 sysdm.cpl을 입력합니다.

2. 고급 탭의 [환경 변수] 버튼을 클릭 후, 환경 변수에 HOME=c:\kiml를 추가합니다.

   그림sysdm.cpl 실행 > 시스템 속성 > 환경 변수 > HOME=c:\kiml 추가

3. Powershell 명령 프롬프트를 열고 pip 명령어를 실행하여 kiml CLI를 설치합니다.

   코드예제KiML 패키지 설치(Windows 환경)

   Shell

   pip install kiml --index-url https://pypi.ml.kakaoicloud-kr-gov.com/simple --trusted-host pypi.ml.kakaoicloud-kr-gov.com    --force-reinstall
   

4. kiml 설치 완료 후, pip show kiml 명령어를 실행하여 정상적으로 설치 여부와 Location의 값을 확인합니다.

   • 만약 Location의 값이 site-packages로 끝난다면, 환경변수를 수정하기 위해 아래 6번과 7번 단계를 수행합니다.

   그림pip show kiml 조회 결과, site-packages로 끝나는 Location

5. (선택) Python 설치가 필요한 경우, Python 공식 홈페이지에서 설치합니다.

   • 설치 화면에서 [v] Add python.exe to PATH 옵션을 선택 후 설치합니다. 해당 조건을 선택 후 설치 시, 6번과 7번 단계를 생략할 수 있습니다.

   그림Python 설치 시, python.exe PATH 설정 옵션 선택

6. (선택) 2번 단계와 동일하게 [환경 변수] 버튼을 클릭해 환경 변수 화면을 엽니다. 사용자 변수 목록에서 path 변수를 클릭하고 [편집] 버튼을 클릭하여 환경 변수 편집 화면을 엽니다.

   그림sysdm.cpl 실행 > 시스템 속성 > 환경 변수 > HOME=c:\kiml 추가

7. (선택) 환경 변수 편집 화면에서 4번 단계에서 확인한 Location 값을 선택하고, [편집] 버튼을 클릭해 site-package를 scripts로 변경한 뒤 [확인] 버튼을 클릭합니다.

   안내
   Location 값으로 추가된 환경 변수가 없다면, 환경 변수 편집 화면에서 [새로 만들기]를 클릭합니다. pip show kiml을 통해 확인한 Location 값을 복사 붙여넣기 한 뒤 site-package를 scripts 로 변경하고 저장합니다.

   그림환경 변수 scripts로 변경

Step 5. KiML CLI 로그인

2단계에서 발급한 Kakao i Cloud (공공) 사용자 액세스 키로 인증 후, KiML CLI에 로그인합니다.

1. KiML CLI 로그인 명령어 kiml login를 입력합니다.

2. Step 2에서 복사한 (1) 사용자 액세스 키 ID와 (2) 사용자 액세스 보안 키를 입력합니다.

3. 사용자 액세스 키 ID와 보안 키가 유효할 경우, KiML CLI 로그인이 완료됩니다.

코드예제kiml login 명령어

kiml login
ApplicationID : {사용자 액세스 키 ID}
ApplicationSecret : {사용자 액세스 보안 키}

주의
KiML CLI 로그인에 이용한 Kakao i Cloud (공공) 사용자 액세스 키를 삭제 시, CLI 로그인 정보가 유효하지 않습니다. 사용자 액세스 키를 재발급 후, CLI 로그인을 시도하시기 바랍니다.