콘솔 시작하기
Kakao i Cloud (공공) 계정으로 Kakao i Machine Learning 공공 클라우드 환경 콘솔에 로그인하는 방법을 안내합니다. 콘솔 로그인 전에 Kakao i Cloud 콘솔 설정 작업이 필요합니다. 자세한 내용은 Kakao i Cloud (공공) 사용자 가이드를 참고하시기 바랍니다.
Kakao i Cloud (공공) 계정 만들기
Kakao i Machine Learning 공공 환경에서는 Kakao i Cloud (공공) 계정을 사용합니다.
Kakao i Cloud (공공)의 계정 생성 방법은 Kakao i Cloud console > 관리자 가이드를 참고하시기 바랍니다.
안내
Kakao i Machine Learning 공공 클라우드 환경은 Kakao i Cloud (공공) 계정과 SSO(Single sign-on)으로 연동되어 있습니다.
Kakao i Cloud (공공) 계정 생성 요청은 카카오 i 클라우드 고객센터(icloudhelpdesk@kakaoenterprise.com)로 문의하시기 바랍니다.
- Kakao i Cloud (공공) 계정 생성 후, hpc-kiml 조직으로 로그인하여 Kakao i Machine Learning 서비스를 이용합니다.
콘솔 로그인하기
Kakao i Machine Learning 공공 클라우드 환경 콘솔에 로그인하는 방법은 다음과 같습니다.
-
[Kakao i Cloud 계정으로 로그인하기] 버튼을 클릭하여, Kakao i Cloud (공공) 로그인 화면으로 이동합니다.
그림Kakao i Machine Learning (공공) 클라우드 환경 로그인 화면
-
콘솔 로그인 화면에서 Kakao i Cloud (공공) 로그인을 위한 계정 정보를 입력합니다.
- 조직 이름에
hpc-kiml
을 입력합니다. - 초대 메일을 받은 이메일 주소(아이디)와 비밀번호를 입력합니다.
그림Kakao i Cloud (공공) 계정으로 Kakao i Machine Learning 콘솔 로그인 (조직 이름: hpc-kiml)
- 조직 이름에
-
Kakao i Machine Learning 공공 클라우드 환경 콘솔에 처음 로그인할 경우, 최초 1회 개인정보 제공 동의가 필요합니다. 개인정보 제공 동의를 거부할 수 있으며, 동의를 거부할 경우 Kakao i Machine Learning 서비스를 이용할 수 없습니다.
그림Kakao i Cloud (공공) 개인정보 제공 동의
-
로그인을 완료하면 워크스페이스 목록으로 이동합니다.
-
생성된 워크스페이스를 선택 후, Kakao i Machine Learning 서비스를 이용합니다.
- 워크스페이스 이름은 Kakao i Cloud (공공) 조직 이름과 동일합니다.
- 워크스페이스 이름 조건은 워크스페이스 > 워크스페이스 이름 정책 문서를 참고하시기 바랍니다.
워크스페이스 구성원 등록 및 역할 추가
안내
Kakao i Cloud (공공) 계정이 있는 사용자만 Kakao i Machine Learning 콘솔 또는 CLI를 이용할 수있습니다.
Kakao i Cloud (공공) 계정 생성 요청은 카카오 i 클라우드 고객센터(icloudhelpdesk@kakaoenterprise.com)로 문의하시기 바랍니다.
-
워크스페이스 목록에서 [역할 관리] 버튼 또는 워크스페이스 상세 화면에서 [+역할 추가] 버튼을 클릭합니다.
- 워크스페이스 관리자 역할이 있는 사용자만 접근 가능합니다.
-
워크스페이스 역할 추가 팝업창에서 워크스페이스에 초대할 구성원의 Kakao i Cloud (공공 리전2) 계정 이메일 주소를 입력합니다.
- Kakao i Cloud (공공) 계정이 유효하지 않을 경우, Kakao i Machine Learning 콘솔 또는 CLI 로그인이 불가합니다.
- Kakao i Cloud 계정 생성 요청은 카카오 i 클라우드 고객센터( icloudhelpdesk@kakaoenterprise.com)로 문의하시기 바랍니다.
- 카카오 i 클라우드 초대 메일(조직: hpc-kiml)을 수신한 뒤, 비밀번호 등록 후 Kakao i Machine Learning 콘솔에 로그인할 수 있습니다.
- Kakao i Cloud (공공) 계정 로그인 시, 조직 이름은 ‘hpc-kiml’입니다.
그림워크스페이스 역할 추가 팝업창에서 Kakao i Cloud (공공) 이메일 주소 입력
-
이메일 주소를 입력한 후, 워크스페이스 역할 추가 팝업창에서 워크스페이스 역할을 선택하고 [추가] 버튼을 클릭합니다.
- 워크스페이스 관리자 역할을 가진 구성원만 해당 워크스페이스 다른 구성원을 초대하거나 내보낼 수 있습니다.
- 그 외 다른 권한은 동일합니다. 워크스페이스 내 모든 리소스를 조회하거나 편집할 수 있습니다.
-
워크스페이스에 추가된 구성원은 별도 절차 없이 해당 워크스페이스에서 Kakao i Machine Learning 서비스를 이용할 수 있습니다.
CLI 시작하기
Kakao i Machine Learning은 CLI 환경에서도 모든 기능을 이용하실 수 있습니다. 아래 안내를 따라 KiML CLI 패키지를 안정적으로 설치 및 이용하기 위해서는 다음과 같은 환경을 권장드립니다.
표권장 환경언어 | 환경 |
---|---|
Shell | - MacOS: Bash - Windows: Powershell |
Python | - 3.8 - 3.9 - 3.10 |
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 > 설정 가이드를 참고하시기 바랍니다.
-
Kakao i Cloud (공공) 콘솔 우측 상단에 위치한 프로필 아이콘을 클릭 후, 설정 > 사용자 액세스 키를 클릭합니다.
-
사용자 액세스 키 화면에서 [사용자 액세스 키를 생성해주세요.]를 클릭합니다.
-
사용자 액세스 키 만들기 팝업창에서 액세스 키 발급에 필요한 정보를 입력한 후, [만들기] 버튼을 클릭해 사용자 액세스 키를 발급합니다.
그림Kakao i Cloud (공공) 사용자 액세스 키 발급 화면
-
사용자 액세스 키 만들기 팝업창에서 발급된 (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 환경
-
시작 메뉴 > Windows 시스템 폴더 > 실행에서
sysdm.cpl
을 입력합니다. -
고급 탭의 [환경 변수] 버튼을 클릭 후, 환경 변수에
HOME=c:\kiml
를 추가합니다.그림sysdm.cpl 실행 > 시스템 속성 > 환경 변수 >
HOME=c:\kiml
추가 -
Powershell 명령 프롬프트를 열고 pip 명령어를 실행하여 kiml CLI를 설치합니다.
코드예제KiML 패키지 설치(Windows 환경)
pip install kiml --index-url https://pypi.ml.kakaoicloud-kr-gov.com/simple --trusted-host pypi.ml.kakaoicloud-kr-gov.com --force-reinstall
-
kiml 설치 완료 후,
pip show kiml
명령어를 실행하여 정상적으로 설치 여부와 Location의 값을 확인합니다.- 만약 Location의 값이 site-packages로 끝난다면, 환경변수를 수정하기 위해 아래 6번과 7번 단계를 수행합니다.
그림pip show kiml 조회 결과, site-packages로 끝나는 Location
-
(선택) Python 설치가 필요한 경우, Python 공식 홈페이지에서 설치합니다.
- 설치 화면에서 [v] Add python.exe to PATH 옵션을 선택 후 설치합니다. 해당 조건을 선택 후 설치 시, 6번과 7번 단계를 생략할 수 있습니다.
그림Python 설치 시, python.exe PATH 설정 옵션 선택
-
(선택) 2번 단계와 동일하게 [환경 변수] 버튼을 클릭해 환경 변수 화면을 엽니다. 사용자 변수 목록에서 path 변수를 클릭하고 [편집] 버튼을 클릭하여 환경 변수 편집 화면을 엽니다.
그림sysdm.cpl 실행 > 시스템 속성 > 환경 변수 >
HOME=c:\kiml
추가 -
(선택) 환경 변수 편집 화면에서 4번 단계에서 확인한 Location 값을 선택하고, [편집] 버튼을 클릭해 site-package를 scripts로 변경한 뒤 [확인] 버튼을 클릭합니다.
안내
Location 값으로 추가된 환경 변수가 없다면, 환경 변수 편집 화면에서 [새로 만들기]를 클릭합니다.pip show kiml
을 통해 확인한 Location 값을 복사 붙여넣기 한 뒤 site-package를 scripts 로 변경하고 저장합니다.그림환경 변수 scripts로 변경
Step 5. KiML CLI 로그인
2단계에서 발급한 Kakao i Cloud (공공) 사용자 액세스 키로 인증 후, KiML CLI에 로그인합니다.
-
KiML CLI 로그인 명령어
kiml login
를 입력합니다. -
Step 2에서 복사한 (1) 사용자 액세스 키 ID와 (2) 사용자 액세스 보안 키를 입력합니다.
-
사용자 액세스 키 ID와 보안 키가 유효할 경우, KiML CLI 로그인이 완료됩니다.
코드예제kiml login 명령어
kiml login
ApplicationID : {사용자 액세스 키 ID}
ApplicationSecret : {사용자 액세스 보안 키}
파라미터 | 설명 |
---|---|
{사용자 액세스 키 ID} | Kakao i Cloud 사용자 액세스 키 ID |
{사용자 액세스 보안 키} | Kakao i Cloud 사용자 액세스 보안 키 |
주의
KiML CLI 로그인에 이용한 Kakao i Cloud (공공) 사용자 액세스 키를 삭제 시, CLI 로그인 정보가 유효하지 않습니다. 사용자 액세스 키를 재발급 후, CLI 로그인을 시도하시기 바랍니다.