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.

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

docs: Document magma_deb VM #13840

Merged
merged 1 commit into from
Sep 5, 2022
Merged

docs: Document magma_deb VM #13840

merged 1 commit into from
Sep 5, 2022

Conversation

voisey
Copy link
Contributor

@voisey voisey commented Sep 5, 2022

Summary

Document how to run the integration tests versus the magma_deb VM.

Test Plan

cd $MAGMA_ROOT/docs && make precommit passes locally.

@voisey voisey requested review from ajahl, nstng, a team and Neudrino September 5, 2022 10:09
@pull-request-size pull-request-size bot added the size/S Denotes a PR that changes 10-29 lines. label Sep 5, 2022
@github-actions
Copy link
Contributor

github-actions bot commented Sep 5, 2022

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 Sep 5, 2022
@github-actions
Copy link
Contributor

github-actions bot commented Sep 5, 2022

dp-workflow

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

Results for commit d08439c.

♻️ This comment has been updated with latest results.

@voisey voisey linked an issue Sep 5, 2022 that may be closed by this pull request
5 tasks
Copy link
Contributor

@Neudrino Neudrino left a comment

Choose a reason for hiding this comment

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

Formally sound.

method by which magma is usually deployed. For everyday development, the `make` installation is
recommended, while the debian installation is useful for testing packages before release.

> **Warning**: These two VMs use the same network configuration, so only one of them should be
Copy link
Contributor

Choose a reason for hiding this comment

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

should seems a bit too nonrestrictive here? Should this not be must not?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I changed "should" to "must" and reworded it slightly. Is it better now?

Spin up and provision the gateway VM, then make and start its services:

1. From `magma/lte/gateway` on the host machine: `vagrant up magma && vagrant ssh magma`
1. Now in the gateway VM: `cd $MAGMA_ROOT/lte/gateway && make run`

#### Debian installation

Spin up the *magma_deb* VM. The services should start automatically:
Copy link
Contributor

Choose a reason for hiding this comment

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

We might want to remove the should here? That would sound more confident.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Done 🙂

@voisey voisey force-pushed the magma-deb-docs branch 2 times, most recently from f894a46 to 5602ccd Compare September 5, 2022 10:32
Spin up and provision the gateway VM, then make and start its services:

1. From `magma/lte/gateway` on the host machine: `vagrant up magma && vagrant ssh magma`
1. Now in the gateway VM: `cd $MAGMA_ROOT/lte/gateway && make run`

#### Debian installation

Spin up the *magma_deb* VM. The services start automatically:
Copy link
Contributor

Choose a reason for hiding this comment

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

~"During provisioning the latest magma gateway debian build from the magma artifactory is installed. This is, the deployed gateway might not match your local repository state."

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Nice suggestion, thanks! I've added this as a warning.

Copy link
Contributor

@nstng nstng left a comment

Choose a reason for hiding this comment

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

lgtm. one suggestion for additional information - feel free to ignore it, might be enough that this is documented in code.

Signed-off-by: Cameron Voisey <cameron.voisey@tngtech.com>
@voisey voisey enabled auto-merge (squash) September 5, 2022 14:41
@voisey voisey merged commit 2880fed into magma:master Sep 5, 2022
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/S Denotes a PR that changes 10-29 lines.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Run integration tests against debian installation in CI
4 participants