# DockerCredentialUsage

Defines which stages of a pipeline require the specified credentials.

- Source: [`pipelines/lib/docker-credentials.ts`](https://github.com/aws/aws-cdk/blob/v2.275.0/packages/aws-cdk-lib/pipelines/lib/docker-credentials.ts#L106)

## Example

```ts
const dockerHubSecret = secretsmanager.Secret.fromSecretCompleteArn(
  this,
  'DHSecret',
  'arn:aws:...'
);
// Only the image asset publishing actions will be granted read access to the secret.
const creds = pipelines.DockerCredential.dockerHub(dockerHubSecret, {
  usages: [pipelines.DockerCredentialUsage.ASSET_PUBLISHING],
});
```

## Members

| Member | Description |
| --- | --- |
| `SYNTH` | Synth/Build. |
| `SELF_UPDATE` | Self-update. |
| `ASSET_PUBLISHING` | Asset publishing. |

## Referenced by

- [`DockerCredential`](/v2/docs/aws-cdk-lib.pipelines.DockerCredential).usages
- [`EcrDockerCredentialOptions`](/v2/docs/aws-cdk-lib.pipelines.EcrDockerCredentialOptions).usages
- [`ExternalDockerCredentialOptions`](/v2/docs/aws-cdk-lib.pipelines.ExternalDockerCredentialOptions).usages