-
Notifications
You must be signed in to change notification settings - Fork 328
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Break out upgrade instructions under docs/installation.md into individual pages
- Loading branch information
Showing
6 changed files
with
145 additions
and
77 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,9 @@ | ||
--- | ||
title: "Upgrade Flux" | ||
weight: 43 | ||
--- | ||
|
||
{{% note %}} | ||
It is safe and advised to use the latest PATCH version when upgrading to a | ||
new MINOR version. | ||
{{% /note %}} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,35 @@ | ||
--- | ||
title: "Upgrade an Azure DevOps deployment of Flux" | ||
--- | ||
|
||
## Before you begin | ||
|
||
You will need the following: | ||
|
||
- Upgraded the Flux CLI to the latest version | ||
|
||
## Generate updated Flux component manifests | ||
|
||
Generate manifests for Flux with ``flux install``: | ||
|
||
```bash | ||
flux install \ | ||
--export > ./flux-system/gotk-components.yaml | ||
``` | ||
|
||
## Commit and push the updated component manifests | ||
|
||
1. Add the manifest | ||
```bash | ||
git add flux-system/gotk-components.yaml | ||
``` | ||
|
||
2. Commit the changes | ||
```bash | ||
git commit -m "Upgrade to $(flux -v)" | ||
``` | ||
|
||
3. Push the changes | ||
```bash | ||
git push | ||
``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,41 @@ | ||
--- | ||
title: "Upgrade using the bootstrap command" | ||
--- | ||
|
||
## Before you begin | ||
|
||
You will need the following: | ||
|
||
- Upgraded the Flux CLI to the latest version | ||
|
||
## Run the bootstrap command | ||
|
||
Update the component manifests with ``flux bootstrap``: | ||
|
||
```bash | ||
flux bootstrap github \ | ||
--owner=my-github-username \ | ||
--repository=my-repository \ | ||
--branch=main \ | ||
--personal | ||
``` | ||
|
||
## Reconcile the changes | ||
|
||
Reconcile manifests from Git and upgrade using ``flux reconcile``: | ||
|
||
```bash | ||
flux reconcile source git flux-system | ||
``` | ||
|
||
## Verify the upgrade | ||
|
||
Verify that the controllers have been upgraded with: | ||
|
||
```bash | ||
flux check | ||
``` | ||
|
||
## Next Steps | ||
|
||
- Learn how to [Setup a GitHub action that opens a PR to update Flux](https://github.com/fluxcd/flux2/tree/main/action). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,41 @@ | ||
--- | ||
title: "In Cluster Upgrade" | ||
description: Direct with flux and kubectl | ||
--- | ||
|
||
## Before you begin | ||
|
||
You will need the following: | ||
|
||
- Upgraded the Flux CLI to the latest version | ||
|
||
## Upgrade Flux | ||
|
||
Use the upgrade method that is similar to how you bootstrapped Flux. | ||
|
||
{{% tabs %}} | ||
{{% tab flux install %}} | ||
Apply the new Flux manifests by running ``flux install``: | ||
|
||
``` | ||
flux install | ||
``` | ||
{{% /tab %}} | ||
{{% tab kubectl %}} | ||
If you've installed Flux directly on the cluster with kubectl, | ||
then rerun the command using the latest manifests from the `main` branch: | ||
|
||
```bash | ||
kustomize build <https://github.com/fluxcd/flux2/manifests/install?ref=main> | kubectl apply -f- | ||
``` | ||
{{% /tab %}} | ||
{{% /tabs %}} | ||
|
||
## Check the upgrade | ||
|
||
Use ``flux check``: | ||
|
||
```bash | ||
flux check | ||
``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,18 @@ | ||
--- | ||
title: "Terraform" | ||
date: 2021-09-12T23:51:42+01:00 | ||
draft: true | ||
--- | ||
|
||
## Update the Flux Provider | ||
|
||
Update the Flux provider to the [latest release](https://github.com/fluxcd/terraform-provider-flux/releases) | ||
and run `terraform apply`. | ||
|
||
### Tell flux to upgrade itself | ||
|
||
Tell Flux to upgrade itself in-cluster or wait for it to pull the latest commit from Git: | ||
|
||
``` | ||
kubectl annotate --overwrite gitrepository/flux-system reconcile.fluxcd.io/requestedAt="$(date +%s)" | ||
``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters