리눅스에서 Tencent cloud COS 연결하기

Tencent cloud에서도 AWS S3와 같은 기능이 있습니다.

바로 COS라는 솔루션으로 Cloud Object Storage 의 약자입니다.

클라우드 저장소인 만큼 리눅스에서 coscli를 설치하여 연결하면 클라우드 스토리지를 사용할 수 있습니다.

 

그럼 연동방법에 대해 알아보겠습니다.

 

인증 키 할당

우선 coscli를 사용하기 위해서는 보안 인증키를 받아야 합니다.

클라우드 콘솔에서 다음과 같이Secret ID와 Secret Key, Zone, bucket name 정보를 받아야 합니다.

클라우드 담당에게 아래와 같은 정보를 받았습니다.

zone：ap-seoul
bucket backup-test
SecretId: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
SecretKey: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

 

COSCLI 설치

1. Linux 버전 COSCLI를 직접 다운받거나 서버에 wget 명령어로 받을수 있습니다

https://github.com/tencentyun/coscli/releases/download/v0.11.1-beta/coscli-linux

wget https://github.com/tencentyun/coscli/releases/download/v0.11.1-beta/coscli-linux

2. 실행파일의 이름을 변경합니다.

mv coscli-linux coscli

3. 명령어를 실행할 수 있게 실행 권한을 줍니다.

chmod 755 coscli

4. 명령 라인 창에 ./coscli --version을 입력하고 다음 정보가 출력되면 설치가 완료된 것입니다.

coscli version v0.11.1-beta

 

반응형

매개변수 확인

COSCLI 사용 방법을 빠르게 보려면 ./coscli --help 명령어를 사용할 수 있습니다.

Used to modify configuration items in the [base] group of the configuration file

Format:
  ./coscli config set [flags]

Example:
  ./coscli config set -t example-token

Usage:
  coscli config set [flags]

Flags:
  -h, --help                   help for set
      --secret_id string       Set secret id
      --secret_key string      Set secret key
      --session_token string   Set session token

Global Flags:
  -c, --config-path string     config file path(default is $HOME/.cos.yaml)
  -e, --endpoint string        config endpoint
  -i, --secret-id string       config secretId
  -k, --secret-key string      config secretKey
  -t, --session-token string   config sessionToken

 

최초 사용 시 COSCLI는 기본적으로 ~/.cos.yaml 위치에 설정 파일을 생성합니다.

또한 ./coscli config init 명령어를 사용하여 다른 위치에 COSCLI에 대한 구성 파일을 인터랙티브식으로 생성할 수 있습니다.

설정 파일의 각 설정 항목에 대한 설명은 다음과 같습니다.

설정 항목설명

Secret ID	키 ID. CAM 콘솔에서 생성 및 획득할 수 있습니다.
Secret Key	키 Key. CAM 콘솔에서 생성 및 획득할 수 있습니다.
Session Token	임시 키 Token. 임시 키를 사용할 때 설정해야 하며, 사용하지 않을 경우 Enter를 눌러 건너뛸 수 있습니다.
APP ID	APP ID는 Tencent Cloud 계정 신청 후 부여되는 계정으로 시스템에서 자동으로 할당되며, 계정 정보에서 가져올 수 있습니다. 버킷의 전체 이름은 <bucketname-appid> 형식으로 Bucket Name과 APP ID의 두 가지 요소로 구성됩니다. 자세한 내용은 버킷 이름 생성 규칙을 참고하십시오.
Bucket Name	버킷의 이름. <bucketname-appid>형식으로 버킷 이름과 APP ID로 구성됩니다. 자세한 내용은 버킷 이름 생성 규칙을 참고하십시오.
Bucket Region	버킷이 위치한 리전. 자세한 내용은 리전 및 액세스 도메인을 참고하십시오.
Bucket Alias	버킷 별칭. 설정 시 BucketName-APPID 대신 BucketAlias를 사용하여 입력해야 하는 명령어의 길이를 줄일 수 있습니다. 이 항목이 설정되어 있지 않으면 BucketAlias의 값은 BucketName-APPID 값입니다.

 

기타 설정 방법

./coscli config init을 사용하여 설정 파일을 인터랙티브식으로 생성하는 것 외에도 수동으로 COSCLI 설정 파일을 작성할 수 있습니다. COSCLI의 설정 파일 형식은 yaml 형식입니다.

설정 파일의 예시는 다음과 같습니다.

cos:
base:
  secretid: XXXXXXXXXXXXXXX
  secretkey: XXXXXXXXXXXXXXXXX
  sessiontoken: ""
buckets:
- name: examplebucket1-1250000000
  alias: bucket1
  region: ap-shanghai
- name: examplebucket2-1250000000
  alias: bucket2
  region: ap-guangzhou
- name: examplebucket3-1250000000
  alias: bucket3
  region: ap-chengdu

주의사항

COSCLI는 기본적으로 ~/.cos.yaml에서 구성 항목을 읽습니다. 사용자 정의 구성 파일을 사용하려면 명령 뒤에 -c (--config-path) 옵션을 추가합니다. 구성 파일에 저장된 secretid/secretkey/sessiontoken은 모두 암호화된 문자열입니다.

다수의 버킷 설정

COSCLI는 여러 개의 버킷을 지원하지만 초기 설정 시 COSCLI는 하나의 버킷에 대한 정보만 설정하도록 요구합니다. ./coscli config add 명령어를 사용하여 추후에 버킷 설정을 추가할 수 있습니다.

 

설정 확인

coscli 설정확인을 통해 인증id, key의 설정값을 확인 할 수 있습니다.

# 설정 확인
./coscli config show


INFO[2023-01-03 11:16:21] Configuration file path:
INFO[2023-01-03 11:16:21]   /home/test/.cos.yaml
INFO[2023-01-03 11:16:21] ====================
INFO[2023-01-03 11:16:21] Basic Configuration Information:
INFO[2023-01-03 11:16:21]   Secret ID:     xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
INFO[2023-01-03 11:16:21]   Secret Key:    xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
INFO[2023-01-03 11:16:21]   Session Token:
INFO[2023-01-03 11:16:21] ====================
INFO[2023-01-03 11:16:21] Bucket Configuration Information:
INFO[2023-01-03 11:16:21] - Bucket 1 :
INFO[2023-01-03 11:16:21]   Name:       backup-test
INFO[2023-01-03 11:16:21]   Endpoint:
INFO[2023-01-03 11:16:21]   Alias:      backup-test

 

 

secret id / key 재설정

인증 키가 변경되었으면 다음 같은 명령으로 인증키를 변경 할 수 있습니다.

# secret id 변경
./coscli config set --secret_id <secret id>

# secret key 변경
./coscli config set --secret_key <secret key>