Skip to content
This repository has been archived by the owner on Jun 26, 2023. It is now read-only.

Update guide to choose OS for the plugin #1038

Merged

Conversation

tcnksm
Copy link
Contributor

@tcnksm tcnksm commented Aug 21, 2020

This changes the plugin installation URL so update the user guide to support it.

@k8s-ci-robot k8s-ci-robot added the cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. label Aug 21, 2020
@k8s-ci-robot
Copy link
Contributor

Hi @tcnksm. Thanks for your PR.

I'm waiting for a kubernetes-sigs member to verify that this patch is reasonable to test. If it is, they should reply with /ok-to-test on its own line. Until that is done, I will not automatically test new commits in this PR, but the usual testing commands by org members will still work. Regular contributors should join the org to skip this step.

Once the patch is verified, the new status will be reflected by the ok-to-test label.

I understand the commands that are listed here.

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.

@k8s-ci-robot k8s-ci-robot added needs-ok-to-test Indicates a PR that requires an org member to verify it is safe to test. size/S Denotes a PR that changes 10-29 lines, ignoring generated files. labels Aug 21, 2020
@tcnksm tcnksm requested a review from adrianludwin August 21, 2020 01:32
Copy link
Contributor

@adrianludwin adrianludwin left a comment

Choose a reason for hiding this comment

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

A few more edits. As mentioned in the other PR, can you please squash all commits and include all documentation (including testing notes) in the commit message, not just the PR description? Thanks!

Comment on lines 47 to 55
# Seletct the OS and architecture type (from v0.5.2) where you run the plugin.
# Currently, you can choose "linux_amd64" or "darwin_amd64" (Mac).
HNC_PLATFORM=linux_amd64

# Download the plugin
curl -L https://github.com/kubernetes-sigs/multi-tenancy/releases/download/hnc-${HNC_VERSION}/kubectl-hns -o ./kubectl-hns

# Download the plugin (from v0.5.2)
curl -L https://github.com/kubernetes-sigs/multi-tenancy/releases/download/hnc-${HNC_VERSION}/kubectl-hns_${HNC_PLATFORM} -o ./kubectl-hns

Copy link
Contributor

Choose a reason for hiding this comment

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

Firstly, there's a typo ("Select", not "Seletct").

Secondly, this has a 0.5.2 instruction, then an instruction that doesn't appear to care which version it's for (but actually does), then another 0.5.2 instruction. How about grouping them:

# HNC v0.5.1 or earlier: download the plugin (Linux only)
curl ...

# HNC v0.5.2 or later: set the platform and download the plugin. The support platforms are:
# * linux_amd64 (Linux on Intel/AMD)
# * darwin_amd64 (MacOS on Intel)
HNC_PLATFORM=linux_amd64
curl ...

Comment on lines 349 to 351
# Set the desired OS and architecture (from v0.5.2)
HNC_PLATFORM=linux_amd64

Copy link
Contributor

Choose a reason for hiding this comment

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

This isn't needed to install the Docker image

Comment on lines 345 to 369
#### Download the kubectl plugin (Linux only)
#### Download the kubectl plugin

The `kubectl-hns` plugin makes most HNC use and administration much easier; we
strongly recommend installing it. Run the following commands from any directory
on your `PATH`.

```bash
# Download the plugin
curl -L https://github.com/kubernetes-sigs/multi-tenancy/releases/download/hnc-${HNC_VERSION}/kubectl-hns -o ./kubectl-hns

# Download the plugin (from v0.5.2)
curl -L https://github.com/kubernetes-sigs/multi-tenancy/releases/download/hnc-${HNC_VERSION}/kubectl-hns_$HNC_PLATFORM} -o ./kubectl-hns

chmod +x ./kubectl-hns
```
Copy link
Contributor

Choose a reason for hiding this comment

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

This section is now sufficiently complicated that I don't think it makes sense to repeat it twice. Instead of a full separate section, can you just add a link to #use-prepare to reference the earlier section?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Ok! Make sense. Let me change it.

Now HNC plugin release binary supports both linux and darwin. This updates
installation guide for it.
@tcnksm tcnksm force-pushed the feature/installation-guide branch from 6083f16 to a824c2b Compare August 26, 2020 03:38
@tcnksm
Copy link
Contributor Author

tcnksm commented Aug 26, 2020

Thank you for the review. Updated and squashed.

@tcnksm tcnksm requested a review from adrianludwin August 26, 2020 03:39
@adrianludwin
Copy link
Contributor

/ok-to-test
/approve
/lgtm

Thanks @tcnksm for this documentation!

@k8s-ci-robot k8s-ci-robot added ok-to-test Indicates a non-member PR verified by an org member that is safe to test. and removed needs-ok-to-test Indicates a PR that requires an org member to verify it is safe to test. labels Aug 26, 2020
@k8s-ci-robot k8s-ci-robot added the lgtm Indicates that a PR is ready to be merged. label Aug 26, 2020
@k8s-ci-robot
Copy link
Contributor

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: adrianludwin, tcnksm

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@k8s-ci-robot k8s-ci-robot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Aug 26, 2020
@k8s-ci-robot k8s-ci-robot merged commit f4b9803 into kubernetes-retired:master Aug 26, 2020
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
approved Indicates a PR has been approved by an approver from all required OWNERS files. cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. lgtm Indicates that a PR is ready to be merged. ok-to-test Indicates a non-member PR verified by an org member that is safe to test. size/S Denotes a PR that changes 10-29 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants