Skip to content

docs: Added better instructions for deploying helm charts#15056

Merged
mpfirrmann merged 5 commits intomagma:masterfrom
MoritzThomasHuebner:helm_docs_update
Mar 6, 2023
Merged

docs: Added better instructions for deploying helm charts#15056
mpfirrmann merged 5 commits intomagma:masterfrom
MoritzThomasHuebner:helm_docs_update

Conversation

@MoritzThomasHuebner
Copy link
Copy Markdown
Contributor

@MoritzThomasHuebner MoritzThomasHuebner commented Feb 23, 2023

Summary

So far there is no existing documentation of the cwf-orc8r, feg-orc8r, lte-orc8r helm charts. The services themselves appear in the docusaurus docs, but there is next to no explanation as to how to actually deploy the helm charts. For someone experienced with kubernetes not much explanation may actually be needed. However, for the average magma developer we should provide some detailed steps as to how to deploy the charts on a local minikube cluster for testing purposes.

I added some sentences in the Deploy on Minikube page about where to find the helm charts and how to deploy them. Crucially, an environment variable needs to be defined in the values files.

Along the way we also found some additional issues:

  • The fluentd secrets need to be applied in a single command with the other secrets
  • A missing /orc8r in the a directory name
  • Some issues with the NMS setup

Test Plan

Following the steps described in the Deploy on Minikube page I was able to deploy the charts for orc8r, cwf-orc8r, feg-orc8r, and lte-orc8r.

Still to do:

  • Deploy elasticsearch/kibana and make sure they connect with fluentd .
  • Screenshot needs updating with the following deployments
    • dp-orc8r (Deploy by running make in the magma/dp directory
    • fluentd
    • nms

Screenshot from 2023-02-27 16-19-25

Screenshot from 2023-02-27 14-13-17

@pull-request-size pull-request-size bot added the size/S Denotes a PR that changes 10-29 lines. label Feb 23, 2023
@github-actions
Copy link
Copy Markdown
Contributor

Thanks for opening a PR! 💯

A couple initial guidelines

Howto

  • Reviews. The "Reviewers" listed for this PR are the Magma maintainers who will shepherd it.
  • Checks. All required CI checks must pass before merge.
  • Merge. Once approved and passing CI checks, use the ready2merge label to indicate the maintainers can merge your PR.

More info

Please take a moment to read through the Magma project's

If this is your first Magma PR, also consider reading

@github-actions github-actions bot added the component: docs Documentation-related issue label Feb 23, 2023
Comment thread docs/readmes/orc8r/dev_minikube.md Outdated
Comment thread docs/readmes/orc8r/dev_minikube.md Outdated
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Feb 23, 2023

DP Lint & Test

0 tests   0 ✔️  0s ⏱️
0 suites  0 💤
0 files    0

Results for commit c5bdd84.

♻️ This comment has been updated with latest results.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Feb 23, 2023

Oops! Looks like you failed the Docs Lint & Check Generated Files In Sync.

Howto

♻️ Updated: ✅ The check is passing the Docs Lint & Check Generated Files In Sync after the last commit.

MoritzThomasHuebner and others added 4 commits March 1, 2023 16:51
Added missing environment variable and pointed to example values files.

Signed-off-by: Moritz Huebner <[email protected]>
Co-authored-by: Sebastian Wolf <[email protected]>
Signed-off-by: Moritz Huebner <[email protected]>
Co-authored-by: Sebastian Wolf <[email protected]>
Signed-off-by: Moritz Huebner <[email protected]>
Co-authored-by: Sebastian Wolf <[email protected]>
Signed-off-by: Moritz Huebner <[email protected]>
@pull-request-size pull-request-size bot added size/M Denotes a PR that changes 30-99 lines. and removed size/S Denotes a PR that changes 10-29 lines. labels Mar 1, 2023
@github-actions github-actions bot added the component: orc8r Orchestrator-related issue label Mar 1, 2023
@MoritzThomasHuebner MoritzThomasHuebner marked this pull request as ready for review March 1, 2023 07:07
@MoritzThomasHuebner MoritzThomasHuebner requested review from a team as code owners March 1, 2023 07:07
--set-file 'secret.certs.files.fluentd\.key'=${CERTS_DIR}/fluentd.key \
--set=docker.registry=${IMAGE_REGISTRY_URL} \
--set=docker.username=${IMAGE_REGISTRY_USERNAME} \
--set=docker.password=${IMAGE_REGISTRY_PASSWORD} |
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All secrets need to be applied together. Otherwise pods fail because they cannot find relevant certs.

Co-authored-by: Sebastian Wolf <[email protected]>
Signed-off-by: Moritz Huebner <[email protected]>
@github-actions github-actions bot removed the component: orc8r Orchestrator-related issue label Mar 1, 2023
Copy link
Copy Markdown
Contributor

@wolfseb wolfseb left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm

@mpfirrmann mpfirrmann merged commit 77fcdc6 into magma:master Mar 6, 2023
lucasgonze pushed a commit to lucasgonze/magma that referenced this pull request Feb 29, 2024
* docs: Added better instructions for deploying helm charts

Added missing environment variable and pointed to example values files.

Signed-off-by: Moritz Huebner <[email protected]>

* docs: Added missing argument to fluentd secret apply step

Co-authored-by: Sebastian Wolf <[email protected]>
Signed-off-by: Moritz Huebner <[email protected]>

* docs: Added `orc8r` in directory structure

Co-authored-by: Sebastian Wolf <[email protected]>
Signed-off-by: Moritz Huebner <[email protected]>

* docs: Fixed directory structure

Co-authored-by: Sebastian Wolf <[email protected]>
Signed-off-by: Moritz Huebner <[email protected]>

* docs: Improved some more docs

Co-authored-by: Sebastian Wolf <[email protected]>
Signed-off-by: Moritz Huebner <[email protected]>

---------

Signed-off-by: Moritz Huebner <[email protected]>
Co-authored-by: Sebastian Wolf <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

component: docs Documentation-related issue size/M Denotes a PR that changes 30-99 lines.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document lte-orc8r, feg-orc8r, and cwf-orc8r helm charts

4 participants