Archive Storage CLI
    • PDF

    Archive Storage CLI

    • PDF

    Article Summary

    Classic/VPC 환경에서 이용 가능합니다.

    OpenStack swift CLI와 호환되는 Archive Storage CLI의 초기 설정 방법부터 간단한 사용 방법 등을 확인합니다.

    초기 설정

    Archive Storage CLI를 사용하기 위한 설치와 인증 방법을 설명합니다.

    설치

    설치 명령어는 다음과 같습니다.

    • Python 3.9 이하:
    pip install python-keystoneclient==3.17.0
    pip install python-swiftclient==3.6.0
    
    • Python 3.10 이상:
    pip install python-keystoneclient==5.1.0
    pip install python-swiftclient==4.3.0
    
    참고

    관련 자료는 다음을 참고해 주십시오.

    인증

    인증 정보를 설정하는 방법은 다음과 같습니다.

    • 요청
      swift --os-auth-url https://kr.archive.gov-ncloudstorage.com:5000/v3 --auth-version 3 \
            --os-username {access_key_id} --os-password {secret_key} \
            --os-user-domain-id {domain_id} --os-project-id {project_id} \
            auth
      
    • 결과
      export OS_STORAGE_URL=https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id}
      export OS_AUTH_TOKEN={token}
      
      • 결과 값에 표시되어 있는 export 명령으로 OS_STORAGE_URL, OS_AUTH_TOKEN를 환경 변수로 선언하여 재인증없이 서비스 요청을 이용 가능
        export OS_STORAGE_URL=https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id}
        export OS_AUTH_TOKEN={token}
        
        swift list
        
      • 환경 변수로 사용하지 않고 --os-storage-url, --os-auth-token 옵션값을 입력해서 사용 가능
        swift --os-storage-url https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id} \
              --os-auth-token {token} \
              list
        
      • 서비스 URL과 토큰값을 저장해서 사용하지 않고 매 요청마다 인증하는 방식으로 사용 가능
        swift --os-auth-url https://kr.archive.gov-ncloudstorage.com:5000/v3 --auth-version 3 \
              --os-username {access_key_id} --os-password {secret_key} \
              --os-user-domain-id {domain_id} --os-project-id {project_id} \
              list
        
        참고

        서비스 요청 전에 매번 인증 요청을 수행하기 때문에 권장하지 않습니다.

    명령어

    Archive Storage CLI를 설명합니다.

    컨테이너 목록조회

    컨테이너 목록을 조회하는 명령어는 다음과 같습니다.

    swift --os-storage-url https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id} \
          --os-auth-token {token} \
          list
    
    참고

    서브 계정의 경우, 컨테이너 목록을 조회 명령어(swift list)를 사용할 수 없습니다.

    오브젝트 목록조회

    오브젝트 목록을 조회하는 명령어는 다음과 같습니다.

    swift --os-storage-url https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id} \
          --os-auth-token {token} \
          list {container}
    

    오브젝트 업로드

    오브젝트를 업로드하는 명령어는 다음과 같습니다.

    swift --os-storage-url https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id} \
          --os-auth-token {token} \
          upload {container} --object-name {object} {local_file_path}
    

    대용량 오브젝트 업로드

    대용량 오브젝트를 업로드할 때는 세그먼트 컨테이너와 매니페스트 컨테이너를 각각 다르게 지정해야 합니다.
    아래는 매니페스트 파일을 container1 에 업로드하고, 세그먼트 파일들을 container2 에 업로드하는 예시 명령어입니다.

    swift --os-storage-url https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id} \
          --os-auth-token {token} \
          upload container1 --object-name {object} {local_file_path} --segment-size {size} --segment-container container2 [--use-slo]
    

    만약 다운로드를 수행하려면, container1 에 업로드된 오브젝트를 다운로드하면 됩니다.

    로컬 경로 전체 업로드

    recursive하게 로컬 경로 전체를 업로드하는 명령어는 다음과 같습니다.

    swift --os-storage-url https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id} \
          --os-auth-token {token} \
          upload {container} {local_file_path}
    

    오브젝트 삭제

    오브젝트를 1개 이상 입력하여 삭제하는 명령어는 다음과 같습니다.

    swift --os-storage-url https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id} \
          --os-auth-token {token} \
          delete {container} {object} [...]
    

    --prefix 옵션을 사용하여 지정한 prefix로 시작하는 오브젝트를 삭제하려면 다음과 같이 명령어를 실행해 주십시오.

    swift --os-storage-url https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id} \
          --os-auth-token {token} \
          delete {container} --prefix {prefix}
    

    컨테이너 삭제

    컨테이너의 모든 오브젝트를 삭제하고 마지막에 컨테이너를 삭제하는 명령어는 다음과 같습니다.

    swift --os-storage-url https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id} \
          --os-auth-token {token} \
          delete {container}
    

    이 문서가 도움이 되었습니까?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.