# Gradle 캐시 {#gradle-cache}

Tuist는 [Gradle의 내장 빌드 캐시](https://docs.gradle.org/current/userguide/build_cache.html)와 통합되어 빌드 아티팩트를 원격으로 공유하는 Gradle 플러그인을 제공합니다. 태스크의 출력이 이미 캐시되어 있으면 Gradle은 실행을 건너뛰고 Tuist의 원격 캐시에서 결과를 가져와 팀과 CI 환경 전체의 빌드 시간을 절약합니다.

<.localized_link href="/guides/install-gradle-plugin">Tuist Gradle 플러그인</.localized_link>이 설치되면, `gradle.properties` 파일에서 Gradle의 빌드 캐시를 활성화해야 합니다:

```properties
org.gradle.caching=true
```

이 설정이 없으면 Gradle은 빌드 캐시 하위 시스템을 활성화하지 않습니다(원격 캐시가 구성되어 있더라도). 따라서 모든 태스크는 캐시를_hit_하거나 채우지 않고 실행됩니다. 활성화되면 Gradle은 Tuist를 원격 빌드 캐시로 사용하여, 캐시 히트 시 캐시된 태스크 출력을 다운로드하고 태스크 실행 후 업로드합니다.

## 캐시 업로드 정책 {#cache-upload-policy}

기본적으로 이 플러그인은 아티팩트를 원격 캐시에 다운로드하고 업로드합니다. `buildCache` 블록의 `push` 옵션을 사용하여 업로드를 제어할 수 있습니다:

```kotlin
tuist {
    buildCache {
        push = false // read-only mode
    }
}
```

일반적인 패턴은 빌드가 재현 가능한 CI에서만 아티팩트를 푸시하고, 로컬 환경은 읽기 전용으로 유지하는 것입니다:

```kotlin
tuist {
    buildCache {
        push = System.getenv("CI") != null
    }
}
```

이 설정을 사용하면 로컬 빌드는 업로드 없이 캐시된 아티팩트의 이점을 누리고, CI 빌드는 팀의 나머지 구성원을 위해 캐시를 채웁니다.

## 지속적 통합(CI) {#continuous-integration}

CI 환경에서는 <.localized_link href="/guides/server/authentication#continuous-integration">인증 가이드</.localized_link>의 방법 중 하나를 사용하여 인증하세요. 제공업체별 CI 예제는 <.localized_link href="/guides/integrations/continuous-integration">지속적 통합 가이드</.localized_link>를 참조하세요.

### 로컬 빌드 캐시 비활성화 {#disabling-the-local-build-cache}

Gradle은 로컬 빌드 캐시와 원격 빌드 캐시를 모두 유지합니다. 로컬 빌드 캐시는 `~/.gradle/caches/build-cache-1` 아래 디스크에 태스크 출력을 저장합니다.

Tuist가 원격 빌드 캐시로 구성된 경우, CI에서 로컬 빌드 캐시를 비활성화하는 것이 좋습니다. 이렇게 하면 CI 러너에 중복된 아티팩트가 저장되는 것을 방지하고, 빌드가 항상 팀의 나머지 구성원을 위해 최신 항목으로 원격 캐시를 채우도록 보장합니다.

`settings.gradle.kts`에서 CI용 Gradle의 로컬 빌드 캐시를 비활성화하세요:

```kotlin
buildCache {
    local {
        isEnabled = System.getenv("CI") == null
    }
}
```

이렇게 하면 로컬 개발에는 로컬 빌드 캐시를 사용할 수 있게 하면서, Tuist의 원격 캐시가 아티팩트 공유를 처리하는 CI에서는 이를 비활성화합니다.

## 구성 참조 {#configuration-reference}

`buildCache` 블록은 다음을 지원합니다:

| 옵션 | 유형 | 기본값 | 설명 |
| --- | --- | --- | --- |
| `enabled` | `Boolean` | `true` | 원격 빌드 캐시가 활성화되어 있는지 여부입니다. |
| `push` | `Boolean` | `true` | 태스크 출력을 원격 캐시에 업로드할지 여부입니다. |
| `allowInsecureProtocol` | `Boolean` | `false` | 안전하지 않은 HTTP 연결을 허용할지 여부입니다. |