- 릴리스 노트 및 공지 사항
- 제품 소개
- 구매 가이드
- 시작하기
- 콘솔 가이드
- 툴 가이드
- 사례 튜토리얼
- 개발자 가이드
- 데이터 레이크 스토리지
- 데이터 처리
- 장애 처리
- FAQ
- Related Agreements
- 용어집
- 릴리스 노트 및 공지 사항
- 제품 소개
- 구매 가이드
- 시작하기
- 콘솔 가이드
- 툴 가이드
- 사례 튜토리얼
- 개발자 가이드
- 데이터 레이크 스토리지
- 데이터 처리
- 장애 처리
- FAQ
- Related Agreements
- 용어집
COSCLI 툴은 Windows, macOS, Linux 운영체제의 이진 패키지를 제공하므로 간단한 설치 및 구성 후 사용할 수 있다.
절차 1: COSCLI 툴 다운로드
비지니스 시나리오에 따라 COSCLI 툴 다운로드를 위한 주소를 선택할 수 있습니다. 귀하의 서버가 국내에 있는 경우 국내 사이트 다운로드 주소를 사용하는 것을 추천합니다.
명령행을 통해 국내 사이트 macOS 및 Linux 환경에서의 COSCLI 툴 파일을 얻을 수 있습니다.
macOS:
wget https://cosbrowser.cloud.tencent.com/software/coscli/coscli-mac macOS-m1:
wget https://cosbrowser.cloud.tencent.com/software/coscli/coscli-mac-m1 Linux:
wget https://cosbrowser.cloud.tencent.com/software/coscli/coscli-linux 설명:
절차 2: COSCLI 툴 설치
Windows
1. 다운로드된 Windows판 COSCLI 툴을 C:\\Users\\<사용자 이름> 디렉터리로 이동합니다.
2.
coscli-windows.exe의 이름을 coscli.exe로 변경합니다.3.
win+r를 클릭하여 실행창을 엽니다.4. 실행창에서
cmd을 입력하고, Enter를 클릭하여 명령행 창을 엽니다.5. 명령행 창에서
coscli --version을 입력하고, 아래 정보가 출력되면 설치 성공을 의미합니다. 설명:
Windows 시스템에서, 상이한 명령행 클라이언트에서 COSCLI를 사용하는 방식은 다소 차이가 있으며, coscli [command]를 입력한 후 COSCLI가 정상적으로 작동하지 않으면 ./coscli [command]의 포맷을 시도해 보세요.coscli version v0.20.0-beta
macOS
1. 아래 명령을 실행하여 macOS판 COSCLI 파일의 이름을 변경합니다.
mv coscli-mac coscli
2. 아래 명령을 실행하여 파일 실행 권한을 변경합니다.
chmod 755 coscli
3. 명령행에서
./coscli --version을 입력하고, 아래 정보가 출력되면 설치 성공을 의미합니다.coscli version v0.20.0-beta
설명:
macOS 시스템에서 COSCLI를 사용할 때
개발자 검증이 불가능하여 “coscli”을 열 수 없음이라는 알림이 뜨면 설정 > 보안성과 개인정보 보호 > 일반으로 이동하여 coscli 계속 열기를 선택하면 COSCLI를 정상적으로 사용할 수 있습니다.Linux
1. 아래 명령을 실행하여 Linux판 COSCLI 파일의 이름을 변경합니다.
mv coscli-linux coscli
2. 아래 명령을 실행하여 파일 실행 권한을 변경합니다.
chmod 755 coscli
3. 명령행 창에서
./coscli --version을 입력하고, 아래 정보가 출력되면 설치 성공을 의미합니다.coscli version v0.20.0-beta
절차 3: COSCLI 툴 구성
주의:
사용자는 임시 키를 통해 툴을 사용하고 임시 인가를 통해 툴 사용의 안전성을 더욱 향상시킬 것이 좋습니다. 임시 키 신청 시, 최소 권한 안내 원칙에 따라 목표 버킷 또는 오브젝트 이외의 리소스 누설을 방지합니다.
반드시 영구 키를 사용하시려면 최소 권한 안내 원칙에 따라 영구 키의 권한 범위를 제한하시기 바랍니다.
COSCLI를 처음 사용할 때, 사용자는 구성 파일을 초기화해야 합니다. 구성 파일은 다음 2개 부분의 내용을 포함합니다.
1. COSCLI가 Tencent Cloud 계정에 접근할 수 있도록 인가하려면 키 ID, 키 Key, 임시 키 Token을 구성해야 합니다.
2. 상용 버킷에 별칭을 추가하려면 상용 버킷 이름, 버킷 소재 리전 정보, 버킷 별칭을 구성해야 합니다. 상용 버킷 정보를 구성한 후, 사용자는 버킷 이름 및 리전 정보를 작성할 필요가 없이 별칭을 사용하여 버킷 작업을 수행할 수 있습니다. 다수의 상용 버킷을 구성한 후 버킷 간 또는 리전 간 작업을 더 간편하게 수행할 수 있습니다. 상용 버킷 정보를 구성할 필요가 없으면
Enter를 클릭하여 건너뛸 수 있습니다.처음 사용할 때 COSCLI는 자동으로
./coscli config init를 호출하여 ~/.cos.yaml 위치에서 구성 파일을 생성하므로 명령행에서 대화식으로 구성을 완성할 수 있습니다. 후속 ./coscli config init 명령을 사용하여 기타 위치에서 COSCLI를 위해 대화식으로 구성 파일을 생성할 수 있습니다. ./coscli config show를 사용하여 구성 파일의 위치 및 구성 매개변수 정보를 조회할 수 있습니다.구성 파일 내 각 구성 항목에 대한 설명은 다음과 같습니다.
구성 항목 | 설명 |
Secret ID | |
Secret Key | |
Session Token | 임시 키 token, 임시 키를 사용할 때 구성이 필요하며, 사용하지 않으면 직접 Enter를 클릭하여 건너뛸 수 있습니다. 임시 키에 관한 더 많은 정보는 임시 키를 사용하여 COS에 접근하기를 참고하시기 바랍니다. |
Mode | 아이덴티티 모드를 설정하고, 열거값 SecretKey 및 CvmRole을 지원합니다. 공백일 수 있고, 공백 값은 기본적으로 SecretKey이며, 키를 사용하여 COS를 요청함을 의미합니다. Mode가 CvmRole인 경우 인스턴스 역할 관리를 사용하여 COS를 요청함을 의미합니다. |
Cvm Role Name | |
protocol | 네트워크 전송 프로토콜은 기본적으로 https입니다. http로 변경하시려면 직접 구성 파일에 들어가서 수정할 수 있다. |
APPID | |
Bucket Name | |
Bucket Endpoint | 버킷 소재 리전의 도메인 이름은 기본 도메인 이름 포맷이 cos.<region>.myqcloud.com이며, 여기서 <region>는 버킷 리전을 나타내며, 예를 들어 ap-guangzhou, ap-beijing 등이며, COS가 지원되는 리전 리스트는 리전과 접근 도메인을 참고하시기 바랍니다.버킷이 글로벌 가속을 활성화한 경우 글로벌 가속 도메인 이름을 구성할 수 있습니다. 예를 들어, 글로벌 가속 도메인 이름을 cos.accelerate.myqcloud.com로 구성하고, 전용망 글로벌 가속 도메인 이름은 cos-internal.accelerate.tencentcos.cn로 구성합니다. |
Bucket Alias | 버킷 별칭, 구성 후 사용할 때 BucketAlias로 BucketName-APPID를 대체하여 입력해야 할 명령어 길이를 줄일 수 있으며, 이 항목을 구성하지 않는 경우 BucketAlias의 값은 BucketName-APPID의 값이다. |
OFS Bucket |
처음 구성할 때 COSCLI는 하나의 버킷의 정보만 구성할 것을 요구하며, 다수의 버킷을 구성하시려면 후속
./coscli config add 명령을 사용하여 버킷 구성을 추가할 수 있습니다. 구성 파일을 수정하거나 더 많은 관련 구성 파일에 대한 작업이 필요하시면 config 명령을 참고하거나 ./coscli config --help 명령을 사용하여 구성 파일과 관련된 명령어를 빠르게 조회할 수 있습니다.명령어를 본격적으로 사용하기 전에
./coscli --help 명령을 사용하여 COSCLI의 사용 방법을 빠르게 조회할 수 있습니다.기타 구성 방법
./coscli config init를 사용하여 대화식으로 구성 파일을 생성하는 것 외에 COSCLI의 구성 파일을 직접 수동으로 작성할 수 있습니다. COSCLI의 구성 파일 포맷은 yaml 포맷이고, 구성 파일 예시는 다음과 같습니다.cos:base:secretid: XXXXXXXXXXXXXXXsecretkey: XXXXXXXXXXXXXXXXXsessiontoken: ""protocol: httpsbuckets:- name: examplebucket1-1250000000alias: bucket1region: ap-shanghaiendpoint: cos.ap-shanghai.myqcloud.comofs: false- name: examplebucket2-1250000000alias: bucket2region: ap-guangzhouendpoint: cos.ap-guangzhou.myqcloud.comofs: false- name: examplebucket3-1250000000alias: bucket3region: ap-chengduendpoint: cos.ap-chengdu.myqcloud.comofs: false
주의:
COSCLI는 기본적으로 ~/.cos.yaml로부터 구성 항목을 읽으며, 사용자가 사용자 정의된 구성 파일을 사용하시려면 명령 뒤에 -c （--config-path） 선택 항목을 사용하세요. 구성 파일에 저장된 secretid/secretkey/sessiontoken은 모두 암호화 후의 문자열입니다.
예
아니오
문제 해결에 도움이 되었나요?