本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 指定本機快取
<a name="specify-caching-local"></a>

您可以使用 AWS CLI、 主控台、 SDK 或 CloudFormation 來指定本機快取。如需本機快取的詳細資訊，請參閱 [本機快取](caching-local.md)。

**Topics**
+ [指定本機快取 (CLI)](#caching-local-cli)
+ [指定本機快取 (主控台)](#caching-local-console)
+ [指定本機快取 (CloudFormation)](#caching-local-cfn)

## 指定本機快取 (CLI)
<a name="caching-local-cli"></a>

您可以使用 中的 `--cache` 參數 AWS CLI 來指定三種本機快取類型的每一個。
+ 若要指定來源快取：

  ```
  --cache type=LOCAL,mode=[LOCAL_SOURCE_CACHE]
  ```
+ 若要指定 Docker 層快取：

  ```
  --cache type=LOCAL,mode=[LOCAL_DOCKER_LAYER_CACHE]
  ```
+ 若要指定自訂快取：

  ```
  --cache type=LOCAL,mode=[LOCAL_CUSTOM_CACHE]
  ```

如需詳細資訊，請參閱[建立建置專案 (AWS CLI)](create-project.md#create-project-cli)。

## 指定本機快取 (主控台)
<a name="caching-local-console"></a>

您可以在主控台的 **Artifacts (成品)** 區段中指定快取。針對**快取類型**，選擇 **Amazon S3** 或 **Local**。如果您選擇 **Local (本機)**，請從三種本機快取選項中選擇一或多種。

![\[透過選擇三個本機快取選項中的一個或多個來指定本機快取。\]](http://docs.aws.amazon.com/zh_tw/codebuild/latest/userguide/images/local-cache.png)


如需詳細資訊，請參閱[建立組建專案 (主控台)](create-project.md#create-project-console)。

## 指定本機快取 (CloudFormation)
<a name="caching-local-cfn"></a>

如果您使用 CloudFormation 指定本機快取，請在 `Cache` 屬性上指定 `Type``LOCAL`。下列 YAML 格式 CloudFormation 程式碼範例會指定所有三種本機快取類型。您可以指定這些類型的任意組合。如果您使用 Docker 層快取，在 `Environment` 下，您必須將 `PrivilegedMode` 設定為 `true`，將 `Type` 設定為 `LINUX_CONTAINER`。

```
CodeBuildProject:
    Type: AWS::CodeBuild::Project
    Properties:
      Name: MyProject
      ServiceRole: <service-role>
      Artifacts:
        Type: S3
        Location: <bucket-name>
        Name: myArtifact
        EncryptionDisabled: true
        OverrideArtifactName: true
      Environment:
        Type: LINUX_CONTAINER
        ComputeType: BUILD_GENERAL1_SMALL
        Image: aws/codebuild/standard:5.0
        Certificate: <bucket/cert.zip>
        # PrivilegedMode must be true if you specify LOCAL_DOCKER_LAYER_CACHE
        PrivilegedMode: true
      Source:
        Type: GITHUB
        Location: <github-location>
        InsecureSsl: true
        GitCloneDepth: 1
        ReportBuildStatus: false
      TimeoutInMinutes: 10
      Cache:
        Type: LOCAL
        Modes: # You can specify one or more cache mode, 
          - LOCAL_CUSTOM_CACHE
          - LOCAL_DOCKER_LAYER_CACHE
          - LOCAL_SOURCE_CACHE
```

**注意**  
預設會為非 VPC 建置啟用 Docker 協助程式。如果您想要將 Docker 容器用於 VPC 建置，請參閱 Docker 文件網站上的[執行期權限和 Linux 功能](https://docs.docker.com/engine/reference/run/#runtime-privilege-and-linux-capabilities)，並啟用特權模式。此外，Windows 不支援特殊權限模式。

如需詳細資訊，請參閱[建立建置專案 (CloudFormation)](create-project.md#create-project-cloud-formation)。