- 릴리스 노트 및 공지 사항
- 제품 소개
- 구매 가이드
- 시작하기
- 콘솔 가이드
- 툴 가이드
- 사례 튜토리얼
- 개발자 가이드
- 데이터 레이크 스토리지
- 데이터 처리
- 장애 처리
- FAQ
- Related Agreements
- 용어집
- 릴리스 노트 및 공지 사항
- 제품 소개
- 구매 가이드
- 시작하기
- 콘솔 가이드
- 툴 가이드
- 사례 튜토리얼
- 개발자 가이드
- 데이터 레이크 스토리지
- 데이터 처리
- 장애 처리
- FAQ
- Related Agreements
- 용어집
명령어 형식
sync 명령어는 파일을 동기화 업로드, 다운로드 또는 복사에 사용되며 cp 명령어와의 차이점은 sync 명령어는 먼저 같은 이름의 파일의 crc64를 비교하고 crc64 값이 같으면 전송하지 않는다는 것입니다.
./coscli sync <source_path> <destination_path> [flag]
설명：
bucketAlias 관련 설명은 다운로드 및 설치 설정을 참고하십시오.
이 명령의 다른 범용 옵션(예시: 버킷 전환, 사용자 계정 전환 등)은 범용 옵션 문서를 참고하십시오.
sync 명령어에는 다음과 같은 flag 옵션이 포함됩니다.
flag 약칭 | flag 전체 명칭 | flag 용도 |
없음 | --include | 특정 패턴이 포함된 파일 |
없음 | --exclude | 특정 패턴이 제외된 파일 |
-r | --recursive | 폴더의 모든 파일 재귀적 순회 여부 |
없음 | --storage-class | 파일 유형 지정(기본값: STANDARD) |
없음 | --part-size | 파일 파트 크기(기본값: 32MB, 최대 5GB 지원) |
없음 | --thread-num | 동시 스레드 수(기본값: 5) |
없음 | --rate-limiting | 단일 링크 속도 제한(0.1 - 100MB/s) |
없음 | --routines | 파일 간 동시 업로드 또는 다운로드 스레드의 파일 수를 지정하며, 기본값은 3입니다. |
없음 | --fail-output | 이 옵션은 업로드 또는 다운로드가 실패할 때 파일의 오류 출력을 활성화할지 여부를 결정합니다(기본값은 true, 활성화). 활성화되면 실패한 파일 전송은 지정된 목록(지정하지 않은 경우 기본값은 ./coscli_output임)에 기록됩니다. 비활성화되면 실패한 파일의 수만 콘솔로 출력됩니다. |
없음 | --fail-output-path | 이 옵션은 업로드 또는 다운로드 실패를 기록하는 파일의 오류 출력 폴더를 지정하는 데 사용됩니다. 사용자 정의 폴더 경로를 제공함으로써 오류 출력 폴더의 위치 및 이름을 제어할 수 있다. 이 옵션을 설정하지 않은 경우 기본 오류 로그 폴더 ./coscli_output를 사용합니다. |
없음 | --retry-num | 빈도 제한 재시도 횟수(기본값은 0, 재시도하지 않음). 1-10회 선택 가능. 여러 대의 컴퓨터가 동시에 동일한 COS 목록에서 다운로드 작업을 실행하는 경우, 이 매개변수를 지정하여 재시도함으로써 빈도 제한 오류를 피할 수 있습니다. |
없음 | --err-retry-num | 오류 재시도 횟수(기본값은 0임). 1-10회로 지정하거나 0으로 설정하여 재시도하지 않음을 나타냅니다. |
없음 | --err-retry-interval | 재시도 간격( --err-retry-num를 1-10로 지정할 때에만 사용 가능). 1-10초의 재시도 간격을 지정하며, 지정하지 않거나 0으로 설정한 경우 매번 재시도 간격은 1-10초 내에서 무작위로 선택됩니다. |
없음 | --only-current-dir | 현재 목록의 파일만 업로드하고 하위 목록 및 그 내용을 무시할지 여부(기본값은 false, 무시하지 않음). |
없음 | --disable-all-symlink | 업로드 시 모든 심볼릭 링크의 하위 파일 및 심볼릭 링크의 하위 목록을 무시할지 여부(기본값은 true, 업로드하지 않음). |
없음 | --enable-symlink-dir | 심볼링 링크의 하위 목록 업로드할지 여부(기본값은 false, 업로드하지 않음). |
없음 | --disable-crc64 | CRC64 데이터 검증 비활성화 여부 (기본값은 false, 검증 활성화). |
없음 | --delete | 지정된 타겟 경로에 있는 임의의 기타 파일을 삭제하고 이번 동기화된 파일만 유지(기본값은 false, 삭제하지 않음) 실수로 데이터가 삭제되는 것을 방지하기 위해 --delete 옵션을 사용하기 전에 버전 제어를 활성화하는 것이 좋습니다. |
없음 | --backup-dir | 타겟측에서 이미 삭제되었지만 소스측에 존재하지 않는 파일을 저장하기 위해 삭제된 파일의 백업을 동기화합니다(다운로드할 때에만 유효하고 --delete=true 시 필히 지정). 업로드 및 버킷 복제는 버전 제어를 사용하여 실수로 삭제되는 데이터를 복구하시기 바랍니다. |
없음 | --force | 확인 알림이 없는 강제 작업 (기본값은 false). |
설명：
sync 명령어는 대용량 파일을 업로드 및 다운로드할 때 동시 업로드/다운로드를 자동으로 활성화합니다.
파일이
--part-size보다 큰 경우 COSCLI는 먼저 파일을 --part-size로 나눈 다음 --thread-num 스레드를 사용하여 업/다운로드 작업을 동시 실행합니다.각 스레드는 링크를 점검합니다. 각 링크에 대해
--rate-limiting 매개변수를 사용하여 단일 링크의 속도를 제한할 수 있습니다. 동시 업/다운로드가 활성화된 경우 총 속도는 --thread- num * --rate-limiting입니다.파일을 파트로 업로드/다운로드할 때 기본적으로 중간 지점 재개가 활성화됩니다.
--include 및 --exclude는 표준 정규식 구문을 지원하므로, 파일 특정 조건 필터링에 사용할 수 있습니다.zsh를 사용할 때 pattern 문자열의 양쪽 끝에 큰따옴표를 넣어야 할 수도 있습니다.
작업 예시
파일 동기화 업로드
./coscli sync ~/example.txt cos://bucket1/example.txt
파일 동기화 다운로드
./coscli sync cos://bucket1/example.txt ~/example.txt
버킷 내 파일 동기화 복사
./coscli sync cos://bucket1/example.txt cos://bucket1/example_copy.txt
버킷 간 파일 동기화 복사
./coscli sync cos://bucket1/example.txt cos://bucket2/example_copy.txt
예
아니오
문제 해결에 도움이 되었나요?