Skip to content

Commit

Permalink
Update AWS quick-start guide (#89)
Browse files Browse the repository at this point in the history
  • Loading branch information
s3rj1k authored Jan 20, 2025
1 parent c8645f6 commit e4005a5
Show file tree
Hide file tree
Showing 3 changed files with 16 additions and 7 deletions.
4 changes: 2 additions & 2 deletions docs/clustertemplates/aws/hosted-control-plane.md
Original file line number Diff line number Diff line change
Expand Up @@ -72,7 +72,7 @@ kind: ClusterDeployment
metadata:
name: aws-hosted-cp
spec:
template: aws-hosted-cp-0-0-3
template: aws-hosted-cp-0-0-4
credential: aws-credential
config:
vpcID: vpc-0a000000000000000
Expand Down Expand Up @@ -108,7 +108,7 @@ kind: ClusterDeployment
metadata:
name: aws-hosted
spec:
template: aws-hosted-cp-0-0-3
template: aws-hosted-cp-0-0-4
credential: aws-credential
config:
vpcID: "{{.spec.network.vpc.id}}"
Expand Down
4 changes: 2 additions & 2 deletions docs/clustertemplates/aws/template-parameters.md
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,7 @@ kind: ClusterDeployment
metadata:
name: cluster-1
spec:
template: aws-standalone-cp-0-0-2
template: aws-standalone-cp-0-0-5
credential: aws-cred
config:
sshKeyName: foobar
Expand All @@ -88,7 +88,7 @@ kind: ClusterDeployment
metadata:
name: cluster-1
spec:
template: aws-eks-0-0-2
template: aws-eks-0-0-3
credential: aws-cred
config:
sshKeyName: foobar
Expand Down
15 changes: 12 additions & 3 deletions docs/quick-start/aws.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,8 @@ with the necessary IAM policies and service account.
export AWS_REGION=<aws-region>
export AWS_ACCESS_KEY_ID=<admin-user-access-key>
export AWS_SECRET_ACCESS_KEY=<admin-user-secret-access-key>
export AWS_SESSION_TOKEN=<session-token> # Optional. If you are using Multi-Factor Auth.
# AWS_SESSION_TOKEN is optional when using Multi-Factor Auth.
export AWS_SESSION_TOKEN=<session-token>
```

2. After these are set, run this command to create the IAM CloudFormation stack:
Expand Down Expand Up @@ -79,6 +80,9 @@ type: Opaque
stringData:
AccessKeyID: AKIAQF+EXAMPLE
SecretAccessKey: EdJfFar6+example
# SessionToken is optional when using Multi-Factor Auth.
# SessionToken: IQoJb3JpZ2luX2VjEK7//+example
```

Apply the YAML to your cluster using the following command:
Expand Down Expand Up @@ -144,6 +148,7 @@ spec:
apiVersion: infrastructure.cluster.x-k8s.io/v1beta2
kind: AWSClusterStaticIdentity
name: aws-cluster-identity
namespace: kcm-system
```
Apply the YAML to your cluster:
Expand All @@ -166,16 +171,20 @@ metadata:
name: my-aws-clusterdeployment1
namespace: kcm-system
spec:
template: aws-standalone-cp-0-0-4
template: aws-standalone-cp-0-0-5
credential: aws-cluster-identity-cred
config:
region: us-west-2
region: us-east-2
controlPlane:
instanceType: t3.small
worker:
instanceType: t3.small
```
> WARNING:
> Don't forget to set proper AWS Region.
>

> NOTE:
> To see available versions for `AWS` template run `kubectl get clustertemplate -n kcm-system`.
>
Expand Down

0 comments on commit e4005a5

Please sign in to comment.