> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt
> Use this file to discover all available pages before exploring further.

# wandb beta sync

export const GitHubLink = ({url, compact = false}) => <a href={url} target="_blank" rel="noopener noreferrer" className={compact ? "source-link" : "github-source-link"}>
    {compact ? "View source" : <>
    <svg width="20" height="20" viewBox="0 0 24 24" fill="currentColor" xmlns="http://www.w3.org/2000/svg">
      <path d="M12 0C5.37 0 0 5.37 0 12c0 5.31 3.435 9.795 8.205 11.385.6.105.825-.255.825-.57 0-.285-.015-1.23-.015-2.235-3.015.555-3.795-.735-4.035-1.41-.135-.345-.72-1.41-1.23-1.695-.42-.225-1.02-.78-.015-.795.945-.015 1.62.87 1.845 1.23 1.08 1.815 2.805 1.305 3.495.99.105-.78.42-1.305.765-1.605-2.67-.3-5.46-1.335-5.46-5.925 0-1.305.465-2.385 1.23-3.225-.12-.3-.54-1.53.12-3.18 0 0 1.005-.315 3.3 1.23.96-.27 1.98-.405 3-.405s2.04.135 3 .405c2.295-1.56 3.3-1.23 3.3-1.23.66 1.65.24 2.88.12 3.18.765.84 1.23 1.905 1.23 3.225 0 4.605-2.805 5.625-5.475 5.925.435.375.81 1.095.81 2.22 0 1.605-.015 2.895-.015 3.3 0 .315.225.69.825.57A12.02 12.02 0 0024 12c0-6.63-5.37-12-12-12z" />
    </svg>
    GitHub source
      </>}
  </a>;

<GitHubLink compact url="https://github.com/wandb/wandb/blob/v0.30.0/wandb/cli/beta.py#L54" />

<h2 id="usage">
  사용
</h2>

```bash theme={"system"}
sync [OPTIONS] [PATHS]...
```

<h2 id="description">
  설명
</h2>

PATHS로 지정한 .wandb 파일을 업로드합니다.

이는 추가 기능과 향상된
UX 및 성능을 제공하는 `wandb sync`의 개선 버전입니다. 향후 `wandb sync`에 통합될 예정입니다.

PATHS에는 .wandb 파일, .wandb 파일이 포함된 run 디렉터리,
그리고 run 디렉터리가 포함된 "wandb" 디렉터리를 지정할 수 있습니다.

예를 들어, 현재 .wandb 디렉터리의 모든 run을 동기화하려면:

```bash theme={"system"}
wandb beta sync ./wandb
```

run 디렉터리를 지정하여 특정 run을 동기화하려면:

```bash theme={"system"}
wandb beta sync ./wandb/run-20250813_124246-n67z9ude
```

또는 다음과 같이 동일하게 표현할 수 있습니다:

```bash theme={"system"}
wandb beta sync ./wandb/run-20250813_124246-n67z9ude/run-n67z9ude.wandb
```

<h2 id="arguments">
  인수
</h2>

| 이름 | 기본값 | 유형 |
| - | - | - |
| `paths` | PATH | False |

<h2 id="options">
  옵션
</h2>

| 플래그 | 유형 | 설명 |
| - | - | - |
| `--live` | BOOL Flag | 아직 로깅 중인 run을 동기화합니다.  run을 생성하는 프로세스가 비정상적으로 크래시되면 멈출 수 있습니다. **기본값**: False |
| `-e, --entity` | STR | 동기화되는 모든 run에 사용할 entity 재정의 값입니다. **기본값**: |
| `-p, --project` | STR | 동기화되는 모든 run에 사용할 프로젝트 재정의 값입니다. **기본값**: |
| `--id` | STR | 동기화되는 모든 run에 사용할 run ID 재정의 값입니다.  이 값을 설정하고 (동일한 entity와 프로젝트의) 여러 파일을 동기화하면 파일은 시작 시간 순서대로 동기화됩니다. 동일한 run에서 재개된 여러 조각을 동기화하는 용도입니다. **기본값**: |
| `--job-type` | STR | 동기화되는 모든 run에 적용할 작업 유형 재정의 값입니다. **기본값**: |
| `--replace-tags` | STR | 'old1=new1,old2=new2' 형식으로 태그 이름을 변경합니다. **기본값**: |
| `--skip-synced` | BOOL Flag | 이 명령으로 이미 동기화된 run을 건너뜁니다. **기본값**: True |
| `--skip-online` | BOOL Flag | 온라인 run을 건너뜁니다. **기본값**: True |
| `--dry-run` | BOOL Flag | 실제로 업로드하지 않고 수행될 작업만 출력합니다. **기본값**: False |
| `--yes` | BOOL Flag | 확인 절차를 건너뜁니다. **기본값**: False |
| `-v, --verbose` | BOOL Flag | 더 자세한 정보를 출력합니다. **기본값**: False |
| `-n` | INT | 한 번에 동기화할 run의 최대 개수입니다.  동일한 run에 속한 여러 파일을 동기화하는 경우, 이 설정과 관계없이 파일은 시작 시간 순서대로 순차 동기화됩니다. 재개된 run이거나 --id 매개변수를 사용할 때 이렇게 동작합니다. **기본값**: 5 |


## Related topics

- [wandb beta](/ko/products/wandb/ref/cli/wandb-beta.md)