From 894b86917ccb6d674952ff25c7a6aa23f9bf02c5 Mon Sep 17 00:00:00 2001 From: ksimm1 Date: Tue, 13 Jun 2023 00:50:25 -0700 Subject: [PATCH] feat(docs): update metallb docs for operator-based version (#9587) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit **Description** update metallb docs for operator-based version **โš™๏ธ Type of change** - [ ] โš™๏ธ Feature/App addition - [ ] ๐Ÿช› Bugfix - [ ] โš ๏ธ Breaking change (fix or feature that would cause existing functionality to not work as expected) - [ ] ๐Ÿ”ƒ Refactor of current code **๐Ÿงช How Has This Been Tested?** **๐Ÿ“ƒ Notes:** **โœ”๏ธ Checklist:** - [ ] โš–๏ธ My code follows the style guidelines of this project - [ ] ๐Ÿ‘€ I have performed a self-review of my own code - [ ] #๏ธโƒฃ I have commented my code, particularly in hard-to-understand areas - [ ] ๐Ÿ“„ I have made corresponding changes to the documentation - [ ] โš ๏ธ My changes generate no new warnings - [ ] ๐Ÿงช I have added tests to this description that prove my fix is effective or that my feature works - [ ] โฌ†๏ธ I increased versions for any altered app according to semantic versioning **โž• App addition** If this PR is an app addition please make sure you have done the following. - [ ] ๐Ÿชž I have opened a PR on [truecharts/containers](https://github.com/truecharts/containers) adding the container to TrueCharts mirror repo. - [ ] ๐Ÿ–ผ๏ธ I have added an icon in the Chart's root directory called `icon.png` --- _Please don't blindly check all the boxes. Read them and only check those that apply. Those checkboxes are there for the reviewer to see what is this all about and the status of this PR with a quick glance._ --- charts/enterprise/metallb-config/Chart.yaml | 2 +- .../docs/img/metallb_guide_apps.png | Bin 0 -> 64200 bytes .../docs/img/metallb_guide_trains.png | Bin 0 -> 22633 bytes .../metallb-config/docs/setup-guide.md | 56 ++++++++++++------ 4 files changed, 38 insertions(+), 20 deletions(-) create mode 100644 charts/enterprise/metallb-config/docs/img/metallb_guide_apps.png create mode 100644 charts/enterprise/metallb-config/docs/img/metallb_guide_trains.png diff --git a/charts/enterprise/metallb-config/Chart.yaml b/charts/enterprise/metallb-config/Chart.yaml index b4e04d5bdbb..dd8144f12cc 100644 --- a/charts/enterprise/metallb-config/Chart.yaml +++ b/charts/enterprise/metallb-config/Chart.yaml @@ -22,7 +22,7 @@ sources: - https://github.com/metallb/metallb - https://metallb.universe.tf type: application -version: 1.1.7 +version: 1.1.8 annotations: truecharts.org/catagories: | - core diff --git a/charts/enterprise/metallb-config/docs/img/metallb_guide_apps.png b/charts/enterprise/metallb-config/docs/img/metallb_guide_apps.png new file mode 100644 index 0000000000000000000000000000000000000000..81b9f5b1171cd03fbdb0ac49375cede90e6a9fe8 GIT binary patch literal 64200 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 Wx96?i#BW;}fWXt$&t;ucLK6U>RFmfb literal 0 HcmV?d00001 diff --git a/charts/enterprise/metallb-config/docs/img/metallb_guide_trains.png b/charts/enterprise/metallb-config/docs/img/metallb_guide_trains.png new file mode 100644 index 0000000000000000000000000000000000000000..2e76f2d617f4c07ea0a33710ce308e3465035d39 GIT binary patch literal 22633 zcmd?R2T+q;)bEQ0Q4q0E6a;KY2Stj2fQrJ4fFKZBs3J9lPy+-3Q2_w~6$wf&(h@=^ zp?5*)y(Aql7{U z{o1F~U@~;4C69}PZ^y%Hnds==JiNJb99-)9Z*d8y)*QjT?HzfHj;`xliF)C&K@)h0 z+L?iLO&E-a+xi7XS6|y=rvh)Z6m%83PP`|LaLRyhBx08TU7c`~w!my@hel2G$Xy%% zT2ZY>iBlrJJ-0Q#+Z#cvtT$N$IOyn-yF-f(bu)&4QC!$q%0DCF#UBNg;f?#d&}BZ_ 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 uEPID+RfM`2sYNJwX&BJ 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 ZvE^e}#Z=`=54fmiM>x8lYvcX>zX66{({2C& literal 0 HcmV?d00001 diff --git a/charts/enterprise/metallb-config/docs/setup-guide.md b/charts/enterprise/metallb-config/docs/setup-guide.md index a24b92c41a8..04de8a55a98 100644 --- a/charts/enterprise/metallb-config/docs/setup-guide.md +++ b/charts/enterprise/metallb-config/docs/setup-guide.md @@ -8,12 +8,26 @@ With MetalLB installed, apps will not be reachable using the integrated loadbala ::: -## 1. Configure Address Pool & L2 Advertisement +## Prerequisites + +- Add the Operators & Enterprise trains to your TrueCharts Catalog. + +![metallb-addtrains](img/metallb_guide_trains.png) + +## 1. Install MetalLB Operator from Operators Train + +![metallb-apps](img/metallb_guide_apps.png) + +Install `metallb` from `operators` train first. There is no config, so just hit save. + +If you previously had `metallb` installed and are attempting to upgrade, follow the steps specified below in [Migrating an existing MetalLB config to operator-based version](#migrating-an-existing-metallb-config-to-operator-version) + +## 2. Set Address Pool & L2 Advertisement in MetalLB-Config + +Install `metallb-config` from enterprise train and create a new entry under `Configure IP Address Pools Object` ![metallb-addpoolbasic](img/metallb_guide_addresspool_basic.png) -Create a new entry under `Configure IP Address Pools Object` - - **Name**: Enter a general name for this IP range. Something like _apps_ or _charts_ for this field is fine. - **Auto Assign**: if you want MetalLB Services to auto-assign IPs from the configured address pool without needing to specify per app. Recommendation is to keep this checked. You can still specify an IP for apps as needed (see step 3). @@ -30,15 +44,23 @@ Create a new entry under `Configure L2 Advertisements`. - **Name**: Enter a basic name for your layer 2 advertisement. - **Address Pool Entry:** This should match the **name** of the address pool created above (not the IP range itself). -_For users with VLANs or multiple subnets, you may reference multiple address pool objects under a single L2 Advertisement entry as needed._ - :::info -Once installed, MetalLB will always show as Stopped. +Once installed, `metallb-config` will always show as Stopped. ::: -## 2. Disable SCALE's Default Loadbalancer +## 3. Optional: Specify IP Address per App or Service + +![metallb-specifyIP](img/metallb_guide_specifyIP.png) + +With MetalLB installed, its is recommended (but optional) to specify IP addresses for your apps. + +For each app, under **Networking and Services**, select `LoadBalancer` Service Type for the Main Service. + +In the **LoadBalancer IP** field, specify an IP address that is within the MetalLB address pool that you configured. Apply the same IP address to the **LoadBalancer IP** field on other services within the app. + +## 4. Disable SCALE's Default Loadbalancer With MetalLB installed and configured, you must now disable SCALE's default loadbalancer. @@ -48,19 +70,9 @@ In the SCALE UI, under **Apps** > **Settings** > **Advanced Settings** Uncheck `Enable Integrated Loadbalancer`. -**This will trigger a restart of Kubernetes and all apps**. After roughly 5-10 minutes, your apps will redeploy using the MetalLB-assigned addresses. +**This will trigger a restart of Kubernetes and all apps**. After roughly 5-10 minutes, your apps will redeploy using the MetalLB-assigned IP addresses. -## 3. Optional: Specify IP Address per App or Service - -![metallb-specifyIP](img/metallb_guide_specifyIP.png) - -With MetalLB installed, you may optionally specify IP addresses for your apps. - -For each app, under **Networking and Services**, select `LoadBalancer` Service Type for the Main Service. - -In the **LoadBalancer IP** field, specify an IP address that is within the MetalLB address pool that you configured. Apply the same IP address to the **LoadBalancer IP** field on other services within the app. - -You may need to stop & restart the app for the IP address to take affect. +## 5. Verify IP Addresses Are Assigned From your SCALE shell, run the command `k3s kubectl get svc -A` to verify the IP addresses assigned for each of your apps. The IPs will be listed under the `EXTERNAL-IP` column. @@ -75,3 +87,9 @@ Known Issue: On the SCALE Installed Applications page, the **Open** buttons on e ::: For details on other configuration options, please reference the [MetaLB documentation](https://metallb.universe.tf/configuration/) + +## Migrating an existing MetalLB config to operator version + +- remove the old `metallb` chart coming from the `enterprise` train +- run this in a **root** shell: `k3s kubectl delete --grace-period 30 --v=4 -k https://github.com/truecharts/manifests/delete` +- Proceed with Steps 1 & 2 in the setup guide above