Skip to content

Commit 949307c

Browse files
brownemikrisctl
andauthored
Update cluster policy docs to recommend AWS IAM ARNs
Updates documentation to suggest using IAM Role ARNs to align with recommended Databricks approach. --------- Co-authored-by: Krishan Sharma <7322715+krisctl@users.noreply.github.com>
1 parent 0d30648 commit 949307c

1 file changed

Lines changed: 15 additions & 2 deletions

File tree

guides/admin/create-cluster-policy-for-matlab-on-databricks.md

Lines changed: 15 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -105,7 +105,7 @@ These fields are required for every MATLAB Desktop cluster policy. They configur
105105

106106
### Docker Image Fields
107107

108-
The three Docker image keys are the same regardless of which container registry you use. Only their values differ. Add the following block to your policy and fill in the values using the reference table that follows.
108+
With the exception of Amazon ECR, the three Docker image keys are identical across all container registries; only their values differ. Add the following block to your policy and fill in the values using the reference table below.
109109

110110
```json
111111
{
@@ -124,15 +124,28 @@ The three Docker image keys are the same regardless of which container registry
124124
}
125125
```
126126

127+
When using an AWS instance profile ARN with Amazon ECR.
128+
129+
```json
130+
{
131+
"aws_attributes.instance_profile_arn": {
132+
"type": "fixed",
133+
"value": "arn:aws:iam::<aws-account-number>:instance-profile/<iam-role-name>"
134+
}
135+
}
136+
```
137+
127138
**Values by Registry:**
128139

129140
| Registry | `docker_image.url` | `docker_image.basic_auth.username` | `docker_image.basic_auth.password` |
130141
| --- | --- | --- | --- |
131-
| AWS ECR | `<aws_account_id>.dkr.ecr.<region>.amazonaws.com/<repository>:<tag>` | AWS | ECR authorization token from `aws ecr get-login-password`. Expires after 12 hours. Consider automating rotation. |
142+
| AWS ECR | `<aws_account_id>.dkr.ecr.<region>.amazonaws.com/<repository>:<tag>` | N/A | For Amazon ECR images, do not include authentication information. Instead, use an instance profile with permissions to pull from the repository. |
132143
| Azure ACR | `<registry>.azurecr.io/<repository>:<tag>` | ACR admin username or service principal client ID | ACR admin password or service principal secret. The principal should have the `acrpull` role. |
133144
| GitHub Container Registry (ghcr.io) | `ghcr.io/<owner>/<repository>:<tag>` | GitHub username | GitHub Personal Access Token (PAT) with `read:packages` scope. |
134145
| Docker Hub | `<username>/<repository>:<tag>` | Docker Hub username | Docker Hub password or access token. |
135146

147+
See also: [Databricks Docker image authentication documentation](https://docs.databricks.com/aws/en/compute/custom-containers#docker-image-authentication).
148+
136149
---
137150

138151
### Optional Fields

0 commit comments

Comments
 (0)