tencent cloud

PrevNext

피드백

키워드를 검색하세요

Recent Pages

문서
Cloud Object Storage
    문서
    Download PDF

    다운로드 및 설치 설정

    마지막 업데이트 시간:2024-11-06 15:36:21
    PDF 다운로드
      COSCLI 툴은 Windows, macOS, Linux 운영체제의 이진 패키지를 제공하므로 간단한 설치 및 구성 후 사용할 수 있다.

      절차 1: COSCLI 툴 다운로드

      비지니스 시나리오에 따라 COSCLI 툴 다운로드를 위한 주소를 선택할 수 있습니다. 귀하의 서버가 국내에 있는 경우 국내 사이트 다운로드 주소를 사용하는 것을 추천합니다.
      국내 사이트 다운로드 주소
      Github 다운로드 주소(해외 사이트를 추천)
      SHA256 검사
      6ee8cae7ea86547d7a5acf57f8d919210f076a785c482aafa90f7099ef61d65a
      6ac7d595fdcc2e1c8ccaf7b5b227fb3a472cfbde76f95856cd9e95249eff75a5
      Mac-amd64
      Mac-amd64
      87796d1b67b3c7e890762a3bf2cec1338699a8cba6da88d1616a44e323c58925
      Mac-arm64
      Mac-arm64
      8fe85a00260cd2ba920d6b50e62e38079d16eb3553c404191afd09a5e6587d9b
      Linux-386
      Linux-386
      5890c250f1c9a22829d7916d7ba29b1c232722fcb20bb51128ae30f8c2c6c478
      0651ec2678cf6f58d80c35656ca60447d9180d09b2c343827506a6a741fa9554
      Linux-arm
      Linux-arm
      b367d11f8068ef699a0932b36237028058f278d7f249494d646dc443d1bec2a3
      7efebfe68836a090c26b0afdf319bdf5c04c834461867b4013806a911404ffad
      명령행을 통해 국내 사이트 macOS 및 Linux 환경에서의 COSCLI 툴 파일을 얻을 수 있습니다.
      Mac-amd64:wget https://cosbrowser.cloud.tencent.com/software/coscli/coscli-darwin-amd64
      Mac-arm64:wget https://cosbrowser.cloud.tencent.com/software/coscli/coscli-darwin-arm64
      Linux-386:wget https://cosbrowser.cloud.tencent.com/software/coscli/coscli-linux-386
      Linux-amd64:wget https://cosbrowser.cloud.tencent.com/software/coscli/coscli-linux-amd64
      Linux-arm:wget https://cosbrowser.cloud.tencent.com/software/coscli/coscli-linux-arm
      Linux-arm64:wget https://cosbrowser.cloud.tencent.com/software/coscli/coscli-linux-arm64
      설명:
      Github에서 현재 버전 번호가 v1.0.2이며, 툴의 최신 버전, 버전 히스토리 및 업데이트 로그가 필요하시면 release로 이동하여 확인하십시오.

      절차 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 v1.0.2

      macOS

      1. 아래 명령을 실행하여 macOS판 COSCLI 파일의 이름을 변경합니다.
      mv coscli-darwin-amd64 coscli
      2. 아래 명령을 실행하여 파일 실행 권한을 변경합니다.
      chmod 755 coscli
      3. 명령행에서 ./coscli --version을 입력하고, 아래 정보가 출력되면 설치 성공을 의미합니다.
      coscli version v1.0.2
      설명:
      macOS 시스템에서 COSCLI를 사용할 때 개발자 검증이 불가능하여 “coscli”을 열 수 없음이라는 알림이 뜨면 설정 > 보안성과 개인정보 보호 > 일반으로 이동하여 coscli 계속 열기를 선택하면 COSCLI를 정상적으로 사용할 수 있습니다.

      Linux

      1. 아래 명령을 실행하여 Linux판 COSCLI 파일의 이름을 변경합니다.
      mv coscli-linux-amd64 coscli
      2. 아래 명령을 실행하여 파일 실행 권한을 변경합니다.
      chmod 755 coscli
      3. 명령행 창에서 ./coscli --version을 입력하고, 아래 정보가 출력되면 설치 성공을 의미합니다.
      coscli version v1.0.2

      절차 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
      키 ID, 서브 계정 키를 사용하고 최소 권한 안내에 따라 인가하여 사용 리스크를 줄이는 것이 좋습니다. 서브 계정 키 획득은 서브 계정 접근 키 관리를 참고하시기 바랍니다.
      Secret Key
      키 Key, 서브 계정 키를 사용하고 최소 권한 안내에 따라 인가하여 사용 리스크를 줄이는 것이 좋습니다. 서브 계정 키 획득은 서브 계정 접근 키 관리를 참고하시기 바랍니다.
      Session Token
      임시 키 token, 임시 키를 사용할 때 구성이 필요하며, 사용하지 않으면 직접 Enter를 클릭하여 건너뛸 수 있습니다. 임시 키에 관한 더 많은 정보는 임시 키를 사용하여 COS에 접근하기를 참고하시기 바랍니다.
      Mode
      아이덴티티 모드를 설정하고, 열거값 SecretKey 및 CvmRole을 지원합니다. 공백일 수 있고, 공백 값은 기본적으로 SecretKey이며, 키를 사용하여 COS를 요청함을 의미합니다. Mode가 CvmRole인 경우 인스턴스 역할 관리를 사용하여 COS를 요청함을 의미합니다.
      Cvm Role Name
      CVM 역할 인스턴스 이름을 설정하려면 인스턴스 역할 관리를 참고하시기 바랍니다.
      protocol
      네트워크 전송 프로토콜은 기본적으로 https입니다. http로 변경하시려면 직접 구성 파일에 들어가서 수정할 수 있다.
      APPID
      APPID는 Tencent Cloud 계정을 성공적으로 신청한 후 획득되는 계정으로서 시스템에 의해 자동으로 할당되며, 계정 정보에서 획득할 수 있다. 버킷의 전칭은 Bucket Name 및 APPID의 2개 요소로 구성되고 포맷은 <BucketName-APPID>이며, 자세한 내용은 버킷 명명 규범을 참고하시기 바랍니다.
      Bucket Name
      버킷 이름과 APPID가 함께 버킷 전칭을 구성하고 포맷은 <BucketName-APPID>이며, 자세한 내용은 버킷 명명 규범을 참고하시기 바랍니다.
      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
      메타데이터 가속 버킷 태그, 해당 버킷의 메타데이터 가속 기능이 활성화되었는지 여부를 식별하기 위해 사용된다.
      Auto Switch Host
      백업 도메인 이름 자동 전환을 끌지 여부를 설정합니다. 옵션값 true | false는 비워둘 수 있습니다.
      설정하지 않거나 값이 false인 경우 백업 도메인 이름이 전환됩니다.
      true로 설정된 경우 백업 도메인 이름을 전환하지 않습니다.
      처음 구성할 때 COSCLI는 하나의 버킷의 정보만 구성할 것을 요구하며, 다수의 버킷을 구성하시려면 후속 ./coscli config add 명령을 사용하여 버킷 구성을 추가할 수 있습니다. 구성 파일을 수정하거나 더 많은 관련 구성 파일에 대한 작업이 필요하시면 config 명령을 참고하거나 ./coscli config --help 명령을 사용하여 구성 파일과 관련된 명령어를 빠르게 조회할 수 있습니다.
      명령어를 본격적으로 사용하기 전에 ./coscli --help 명령을 사용하여 COSCLI의 사용 방법을 빠르게 조회할 수 있습니다.

      기타 구성 방법

      ./coscli config init를 사용하여 대화식으로 구성 파일을 생성하는 것 외에 COSCLI의 구성 파일을 직접 수동으로 작성할 수 있습니다. COSCLI의 구성 파일 포맷은 yaml 포맷이고, 구성 파일 예시는 다음과 같습니다.
      cos:

        base:

          secretid: XXXXXXXXXXXXXXX

          secretkey: XXXXXXXXXXXXXXXXX

          sessiontoken: ""

          protocol: https

        buckets:

        - name: examplebucket1-1250000000

          alias: bucket1

          region: ap-shanghai

          endpoint: cos.ap-shanghai.myqcloud.com

          ofs: false

        - name: examplebucket2-1250000000

          alias: bucket2

          region: ap-guangzhou

          endpoint: cos.ap-guangzhou.myqcloud.com

          ofs: false

        - name: examplebucket3-1250000000

          alias: bucket3

          region: ap-chengdu

          endpoint: cos.ap-chengdu.myqcloud.com

          ofs: false
      주의:
      COSCLI는 기본적으로 ~/.cos.yaml로부터 구성 항목을 읽으며, 사용자가 사용자 정의된 구성 파일을 사용하시려면 명령 뒤에 -c （--config-path） 선택 항목을 사용하세요. 구성 파일에 저장된 secretid/secretkey/sessiontoken은 모두 암호화 후의 문자열입니다.
      문의하기

      고객의 업무에 전용 서비스를 제공해드립니다.

      문의하기
      기술 지원

      더 많은 도움이 필요하시면, 티켓을 통해 연락 바랍니다. 티켓 서비스는 연중무휴 24시간 제공됩니다.

      티켓 제출
      연중무휴 24시간 전화 지원
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      개인정보 처리방침서비스 약관쿠키 정책