Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update installation docs with redeployment lessons learned. #4037

Merged
merged 2 commits into from
Dec 23, 2024
Merged

Update installation docs with redeployment lessons learned. #4037

Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
792f396
Update installation docs with redeployment lessons learned.
athornton Dec 23, 2024
faa44c9
Repeat how-to-find-proper-argocd-version instructions
athornton Dec 23, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions docs/admin/installation.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,8 @@ These can be run repeatedly to reinstall Phalanx over an existing deployment.
Be aware that this will invalidate any existing AppRole for that environment.

#. Set the environment variables ``VAULT_ROLE_ID`` and ``VAULT_SECRET_ID`` to the Role ID and Secret ID printed out by that command.
Don't store these anywhere
If you repeat the installation from scratch, just generate new role and secret IDs.

#. Ensure that your default Kubernetes cluster for :command:`kubectl` and :command:`helm` is set to point to the Kubernetes cluster into which you want to install the Phalanx environment.
You can verify this with :command:`kubectl config current-context`.
Expand All @@ -50,10 +52,15 @@ These can be run repeatedly to reinstall Phalanx over an existing deployment.
#. If you are deploying on Google Cloud Platform, consider converting the dynamically-assigned IP address to a static IP.
You can do this in the GCP console under :menuselection:`VPC Network -> IP addresses`.

#. If you are doing a complete reinstallation of a Phalanx instance (e.g. Kubernetes has been completely destroyed and the cluster recreated), you may wish to run ``phalanx secrets sync --regenerate`` in order to recreate any randomly-generated secrets, rather than using the set from the previous installation.

#. Debug any problems during installation.
The most common source of problems are errors or missing configuration in the :file:`values-{environment}.yaml` files you created for each application.
You can safely run the installer repeatedly as you debug and fix issues.

* If you get a message indicating that ``argocd`` plaintext login has failed, the actual error is that your local ``argocd`` executable is obsolete.
Update ``argocd`` and try again.

Using a Vault token rather than AppRole
=======================================

Expand Down
Loading