Merge pull request #2735 from arnaldo2792/systemd-docs

Add boot sequence documentation
bottlerocket-os · Jan 28, 2023 · be228e8 · be228e8
2 parents cde9a2a + aec17df
commit be228e8
Show file tree

Hide file tree

Showing 3 changed files with 9 additions and 5 deletions.
diff --git a/sources/api/README.md b/sources/api/README.md
@@ -143,12 +143,16 @@ Some day we may need to make an earlier service (say, apiserver) configurable th
 This usage is scoped to the keys that have changed, updating relevant config files and restarting affected services.
 See [thar-be-settings](thar-be-settings/) docs.
 
-### configured.target
+## Boot stages
 
-This is a systemd target that depends on [settings-applier](#settings-applier) and represents the point at which the system is fully configured.
+Bottlerocket's boot sequence includes three systemd targets:
 
-Applications can depend on this in their service definition.
-Services like Kubernetes and containerd depend on this.
+- `preconfigured.target`: this is the target where all the aforementioned services run.
+Once all the dynamically generated configurations are created, the system transitions to the next target
+- `configured.target`: this is the target that represents the point at which the system is fully configured.
+[Bootstrap containers](../../bootstrap-containers-settings) will run at this stage to apply further configurations in the system.
+Once all bootstrap containers exit successfully, the system transitions to the next target
+- `multi-user.target`: this is the target where the kubelet or the ECS agent run, at this point no further configurations are required in the running system.
 
 ## Development
 

diff --git a/sources/api/api-system.drawio b/sources/api/api-system.drawio
@@ -1 +1 @@
-<mxfile modified="2020-03-10T23:11:10.980Z" host="drawio.corp.amazon.com" agent="Mozilla/5.0 (X11; Linux x86_64; rv:73.0) Gecko/20100101 Firefox/73.0" etag="HDNx51gGrBdV3yEThMaR" version="12.4.8" type="device"><diagram id="vL4lszIxdcRJnpUGa12-" name="Page-1">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</diagram></mxfile>
+<mxfile modified="2023-01-12T21:38:34.023Z" host="Electron" agent="5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/20.7.4 Chrome/106.0.5249.199 Electron/21.3.3 Safari/537.36" etag="BefRutYJ_UJN7pLE6y2h" version="20.7.4" type="device"><diagram id="vL4lszIxdcRJnpUGa12-" name="Page-1">3Vpbc9o4FP41zHQfyPiCHfKYQJJOu5mkYXY23ZeOsIXRRFiOLAL0169ky/giGbtgCG1eYh9Jx/Z3vnPRET17tFjfUxDNH4gPcc8y/HXPHvcsy7Rdi/8Tkk0qGdpOKggo8uWkXDBBP6EUGlK6RD6MSxMZIZihqCz0SBhCj5VkgFKyKk+bEVx+agQCqAgmHsCq9F/ks7mUmoaRD3yGKJjLRw8dObAA2WQpiOfAJ6uCyL7t2SNKCEuvFusRxAK8DJd03V3N6PbFKAxZmwU3z/Af7+3LV/eeztfjZ/hqTcK+1PIO8FJ+cM9yMdd346N3fhmIywUKKGCEZkP8GYVR+XVsk0FGyTL0oXiqyYdXc8TgJAKeGF1xknDZnC2wHFa/InslSBlcF0Tyq+4hWUBGN3yKpJQ5kJRa5QYaStDnBdNkzAOSEsFWU44av5DA/QKItgJizNGCK4JnHweOHL2SQJwLVgMFKx8wkGDEIVPg4k4TiUtvgxHHjTZjNk0B/nu6FQDvNUhgf1wyrgV2B67jlMBVoXU10GZwdw6to0ALAcWb/pSHmD6PjzMUaJz70wzRmPF1Yhr/R0K8+SubN6W5l5+X78vRNvw2zVMS3FWsACIUQ8q/SUGLq+N5DDYjNSMhk7nRHHaDnH1ZRk6Dm3VK9ppqFFXxCv1rkdNFQMAgjpHHsYgZoEwVF9BLZtwh3Mi7mCypB5vTJdcXQNYc5aBfKi5UWxTQdjRgZzIKMWDovVyS6Cwgn/BEUMhyU5sVHzEq3E8/Wy4qVhAVPW6FMRU1KSqKmoQN228+gCBqfNuDICERCaCOHcZB7LB/S3b0t34u7TrYlx/9Skixj8eQh8GLNQE/v92NHvv0PwAerM9YW8y2IUiblNRofKel8d0zM77ZlfHdjzW+9ZHGd39Tz/9TjL9v7VBNAzXJo1A7wDViLzJTiOvvhevxunizOTifDP+MkGJ3xaojVhz6fGJ8ZEwx2xabZ27+QdVq+5pfiU7dmf9l4htfGb779v5jYt8Gq7GFnjXlxDIWmzgj7VjUdCq4qQHGEJOAggUnQAQp4m8iWhflsad84BQb5UptZhnqhu9Kwwqrg32yFt1T5etdpm10LeesXKsaVy8re/G2jmXb1bhaUdSdY83eVo9v1140cyer8ebx+set62kaVYrpRcMuak/7bf8fTDMNht5SctVgUNkTZ3ugpv6HedmBQ2hRaVHD1KCyE+T9oToJFNrEO+wWCvtgKLLDq5ZNsivjSMDoPEfp6MaQMRQGfF4AQ5ic3MR17VtlcfvO75ksvbi46KBbbTQnYR/E821nW9w8Acazd5hILGMg2rR8nzAimNBEvT1L/riccKWICRI5RrKnoOR1e5zI+XYjqIk8gK8xCoRCRiJtftvpLc21wCl4q82jVwpvI7xkRDFIVkTFDEaV2kmIfqFkmqE1zI6T9bXCgVjW5GRNGjE0SNvHihDq8YMC8p5ddA4c3SRb3wsnu/1eHMu3v8ld/f53V5Aulm67QmBj6SYteSalW3+r6OBNsWVUq7fT9uHV5BzzKEqCHdG1xVlgLEIkT1opZ4CMgx7nTOLtB2b62oze9tiri+NC7RvvX+p0Vgu7xp61sHusdGGqW29Z1MR9EEUYac5SD2BbS3K1zw3HJxe/zX85lHp2/vsr+/Z/</diagram></mxfile>
diff --git a/sources/api/api-system.png b/sources/api/api-system.png
Original file line number	Diff line number	Diff line change
		@@ -1 +1 @@
		<mxfile modified="2020-03-10T23:11:10.980Z" host="drawio.corp.amazon.com" agent="Mozilla/5.0 (X11; Linux x86_64; rv:73.0) Gecko/20100101 Firefox/73.0" etag="HDNx51gGrBdV3yEThMaR" version="12.4.8" type="device"><diagram id="vL4lszIxdcRJnpUGa12-" name="Page-1">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</diagram></mxfile>
		<mxfile modified="2023-01-12T21:38:34.023Z" host="Electron" agent="5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/20.7.4 Chrome/106.0.5249.199 Electron/21.3.3 Safari/537.36" etag="BefRutYJ_UJN7pLE6y2h" version="20.7.4" type="device"><diagram id="vL4lszIxdcRJnpUGa12-" name="Page-1">3Vpbc9o4FP41zHQfyPiCHfKYQJJOu5mkYXY23ZeOsIXRRFiOLAL0169ky/giGbtgCG1eYh9Jx/Z3vnPRET17tFjfUxDNH4gPcc8y/HXPHvcsy7Rdi/8Tkk0qGdpOKggo8uWkXDBBP6EUGlK6RD6MSxMZIZihqCz0SBhCj5VkgFKyKk+bEVx+agQCqAgmHsCq9F/ks7mUmoaRD3yGKJjLRw8dObAA2WQpiOfAJ6uCyL7t2SNKCEuvFusRxAK8DJd03V3N6PbFKAxZmwU3z/Af7+3LV/eeztfjZ/hqTcK+1PIO8FJ+cM9yMdd346N3fhmIywUKKGCEZkP8GYVR+XVsk0FGyTL0oXiqyYdXc8TgJAKeGF1xknDZnC2wHFa/InslSBlcF0Tyq+4hWUBGN3yKpJQ5kJRa5QYaStDnBdNkzAOSEsFWU44av5DA/QKItgJizNGCK4JnHweOHL2SQJwLVgMFKx8wkGDEIVPg4k4TiUtvgxHHjTZjNk0B/nu6FQDvNUhgf1wyrgV2B67jlMBVoXU10GZwdw6to0ALAcWb/pSHmD6PjzMUaJz70wzRmPF1Yhr/R0K8+SubN6W5l5+X78vRNvw2zVMS3FWsACIUQ8q/SUGLq+N5DDYjNSMhk7nRHHaDnH1ZRk6Dm3VK9ppqFFXxCv1rkdNFQMAgjpHHsYgZoEwVF9BLZtwh3Mi7mCypB5vTJdcXQNYc5aBfKi5UWxTQdjRgZzIKMWDovVyS6Cwgn/BEUMhyU5sVHzEq3E8/Wy4qVhAVPW6FMRU1KSqKmoQN228+gCBqfNuDICERCaCOHcZB7LB/S3b0t34u7TrYlx/9Skixj8eQh8GLNQE/v92NHvv0PwAerM9YW8y2IUiblNRofKel8d0zM77ZlfHdjzW+9ZHGd39Tz/9TjL9v7VBNAzXJo1A7wDViLzJTiOvvhevxunizOTifDP+MkGJ3xaojVhz6fGJ8ZEwx2xabZ27+QdVq+5pfiU7dmf9l4htfGb779v5jYt8Gq7GFnjXlxDIWmzgj7VjUdCq4qQHGEJOAggUnQAQp4m8iWhflsad84BQb5UptZhnqhu9Kwwqrg32yFt1T5etdpm10LeesXKsaVy8re/G2jmXb1bhaUdSdY83eVo9v1140cyer8ebx+set62kaVYrpRcMuak/7bf8fTDMNht5SctVgUNkTZ3ugpv6HedmBQ2hRaVHD1KCyE+T9oToJFNrEO+wWCvtgKLLDq5ZNsivjSMDoPEfp6MaQMRQGfF4AQ5ic3MR17VtlcfvO75ksvbi46KBbbTQnYR/E821nW9w8Acazd5hILGMg2rR8nzAimNBEvT1L/riccKWICRI5RrKnoOR1e5zI+XYjqIk8gK8xCoRCRiJtftvpLc21wCl4q82jVwpvI7xkRDFIVkTFDEaV2kmIfqFkmqE1zI6T9bXCgVjW5GRNGjE0SNvHihDq8YMC8p5ddA4c3SRb3wsnu/1eHMu3v8ld/f53V5Aulm67QmBj6SYteSalW3+r6OBNsWVUq7fT9uHV5BzzKEqCHdG1xVlgLEIkT1opZ4CMgx7nTOLtB2b62oze9tiri+NC7RvvX+p0Vgu7xp61sHusdGGqW29Z1MR9EEUYac5SD2BbS3K1zw3HJxe/zX85lHp2/vsr+/Z/</diagram></mxfile>