Synthesize a cluster
|"Synthesize" is the act of making a cluster managed by Project Syn|
This how-to will show you how to synthesize a cluster.
Create a new cluster in control.vshn.net. See section "creating a new cluster on control.vshn.net" of the "Synthesize a cluster" explanation for a more detailed breakdown of the form fields.
Note down the
kubectlcommand shown, you’ll need it later.
Right now, you need to refresh the page you land on after creating a cluster in order for the command to be shown. We are working on addressing this issue, see Jira ticket PORTAL-50.
Run Commodore to create a local checkout of the new cluster’s configuration. See the Project Syn "compile a catalog" how-to. Use
https://api.syn.vshn.netas the value for
LIEUTENANT_URL. Skip the "Cleanup" of that tutorial step for now.
Add any required initial configurations to your new cluster in
commodore catalog compile --push <cluster-id>to push the initial cluster catalog to git.vshn.net.
Create any required secrets in Vault. See the section on adding required tokens to Vault for a more detailed explanation on adding secrets.
If you can’t add secrets to Vault, ask for
synrootgroup privileges in Vault.
Install Steward on the new cluster by executing the
kubectlcommand you noted down in step 2.
Make sure the
kubectlcommand in this step is executed against the cluster to synthesize
See the documentation of the bootstrap token and install URL for a more detailed explanation, including instructions on how to fetch the install URL from the Lieutenant API and instructions to reset the bootstrap token.