Skip to content

Commit 8f59027

Browse files
committed
Add a guide to upload an ignition config to AWS S3
Then create the instance with a minimal config pointing to the s3 bucket Fixes #414
1 parent 34cdab5 commit 8f59027

File tree

1 file changed

+42
-0
lines changed

1 file changed

+42
-0
lines changed

modules/ROOT/pages/provisioning-aws.adoc

+42
Original file line numberDiff line numberDiff line change
@@ -59,3 +59,45 @@ You now should be able to SSH into the instance using the associated IP address.
5959
----
6060
ssh core@<ip address>
6161
----
62+
63+
==== Remote ignition configuration
64+
65+
As user-data is limited to 16 KB, you may need to use an external source for your ignition configuration.
66+
A common solution is to upload the config to a S3 bucket, as the following steps show:
67+
68+
[source, bash]
69+
.Create a new s3 bucket
70+
----
71+
NAME='instance1'
72+
aws s3 mb s3://$NAME-infra
73+
----
74+
75+
[source, bash]
76+
.Upload the ignition file
77+
----
78+
NAME='instance1'
79+
USERDATA='/path/to/config.ign' # path to your Ignition config
80+
aws s3 cp $USERDATA s3://$NAME-infra/bootstrap.ign
81+
----
82+
83+
You can verify the file have been correctly uploaded:
84+
[source, bash]
85+
.List files in the bucket
86+
----
87+
NAME='instance1'
88+
aws s3 ls s3://$NAME-infra/
89+
----
90+
91+
Then create a minimal Ignition config as follows:
92+
[source,yaml]
93+
.Retrieving a remote Ignition file from a s3 bucket
94+
----
95+
variant: fcos
96+
version: 1.4.0
97+
ignition:
98+
config:
99+
replace:
100+
source: s3://instance1-infra/bootstrap.ign
101+
----
102+
103+
Then you can launch the instance using the same command as xref:#_customized_example[], passing the minimal configuration you just created.

0 commit comments

Comments
 (0)