-
Notifications
You must be signed in to change notification settings - Fork 10
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #25 from little-angry-clouds/feature/add_oc_binary
feat: add oc binary
- Loading branch information
Showing
11 changed files
with
396 additions
and
24 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
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,5 @@ | ||
| # OC Wrapper | ||
|
|
||
| This is a OC wrapper. It doesn't do much more than execute every command as | ||
| is. The only special thing it does is to choose which version to use. Just use | ||
| it as a substitute of the binary. Please refer to [ocenv](../ocenv/README.md). |
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,11 @@ | ||
| package main | ||
|
|
||
| import ( | ||
| "github.com/little-angry-clouds/kubernetes-binaries-managers/internal/wrapper" | ||
| ) | ||
|
|
||
| func main() { | ||
| var binName string = "oc" | ||
|
|
||
| wrapper.Wrapper(binName) | ||
| } |
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,165 @@ | ||
|     | ||
|
|
||
| # ocenv | ||
|
|
||
| [OC](https://docs.openshift.com/container-platform/4.2/cli_reference/openshift_cli/getting-started-cli.html) version | ||
| manager inspired by [tfenv](https://github.com/tfutils/tfenv/). | ||
|
|
||
| ## Features | ||
|
|
||
| - Install OC versions in a reproducible and easy way | ||
| - Enforce version in your git repositories with a `.oc_version` file | ||
|
|
||
| ## Supported OS | ||
|
|
||
| Currently ocenv supports the following OSes | ||
|
|
||
| - Mac OS | ||
| - Linux | ||
| - Windows | ||
|
|
||
| ## Installation | ||
|
|
||
| There are two components in `ocenv`. One is the `ocenv` binary, the other one | ||
| is a `oc` wrapper. It works as if were `oc`, but it has some logic to choose | ||
| the version to execute. You should take care and ensure that you don't have any | ||
| `oc` binary in your path. To check which binary you're executing, you can see | ||
| it with: | ||
|
|
||
| ```bash | ||
| $ which oc | ||
| /opt/brew/bin/oc | ||
| ``` | ||
|
|
||
| ### Homebrew | ||
|
|
||
| This is the recomended way, since it provides upgrades. It should work in Mac, | ||
| Linux and Windows with WSL. | ||
|
|
||
| ```bash | ||
| # Just the first time, activate the repository | ||
| brew tap little-angry-clouds/homebrew-my-brews | ||
| # To install | ||
| brew install ocenv | ||
| # To upgrade | ||
| brew upgrade ocenv | ||
| ``` | ||
|
|
||
| You should add your `homebrew` binary path to your PATH: | ||
|
|
||
| ```bash | ||
| echo 'export PATH="$(brew --prefix)/bin/:$PATH"' >> ~/.bashrc | ||
| # Or | ||
| echo 'export PATH="$(brew --prefix)/bin/:$PATH"' >> ~/.zshrc | ||
| ``` | ||
|
|
||
| For Windows you should do the weird stuff that it needs to set an environmental variable. | ||
|
|
||
| ### Manually | ||
|
|
||
| 1. Add `~/.bin` to your `$PATH` and create it if doesn't exist | ||
|
|
||
| ```bash | ||
| echo 'export PATH="$HOME/.bin:$PATH"' >> ~/.bashrc | ||
| # Or | ||
| echo 'export PATH="$HOME/.bin:$PATH"' >> ~/.zshrc | ||
|
|
||
| mkdir -p ~/.bin | ||
| ``` | ||
|
|
||
| 2. Download the binaries and put them on your path | ||
|
|
||
| Go to [the releases | ||
| page](https://github.com/little-angry-clouds/kubernetes-binaries-managers/releases) | ||
| and download the version you want. For example: | ||
|
|
||
| ```bash | ||
| wget https://github.com/little-angry-clouds/kubernetes-binaries-managers/releases/download/0.0.4/ocenv-linux-amd64.tar.gz | ||
| tar xzf ocenv-linux-amd64.tar.gz | ||
| mv ocenv-linux-amd64 ~/.bin/ocenv | ||
| mv oc-wrapper-linux-amd64 ~/.bin/oc | ||
| ``` | ||
|
|
||
| And that's it! | ||
|
|
||
| ## Usage | ||
|
|
||
| ### Help | ||
|
|
||
| ```bash | ||
| $ ocenv help | ||
| Oc version manager | ||
|
|
||
| Usage: | ||
| ocenv [command] | ||
|
|
||
| Available Commands: | ||
| help Help about any command | ||
| install Install binary | ||
| list Lists local and remote versions | ||
| uninstall Uninstall binary | ||
| use Set the default version to use | ||
|
|
||
| Flags: | ||
| -h, --help help | ||
|
|
||
| Use "ocenv [command] --help" for more information about a command. | ||
| ``` | ||
|
|
||
| ### List installable versions | ||
|
|
||
| This option uses Github API to paginate all versions. Github API has some usage | ||
| limitations. It usually works, but if you happen to do a lot of requests to | ||
| github or are on an office or similar, chances are that this command will fail. | ||
| You can still install binaries if you know the version you want, thought. | ||
|
|
||
| ```bash | ||
| $ ocenv list remote | ||
| 4.7.0-0.okd-2021-07-03-190901 | ||
| 4.7.0-0.okd-2021-06-19-191547 | ||
| 4.7.0-0.okd-2021-06-13-090745 | ||
| 4.7.0-0.okd-2021-06-04-191031 | ||
| 4.7.0-0.okd-2021-05-22-050008 | ||
| 4.7.0-0.okd-2021-04-24-103438 | ||
| 4.7.0-0.okd-2021-04-11-124433 | ||
| ... | ||
| ``` | ||
|
|
||
| ### List installed versions | ||
|
|
||
| ```bash | ||
| $ ocenv list local | ||
| 4.7.0-0.okd-2021-07-03-190901 | ||
| 4.7.0-0.okd-2021-06-19-191547 | ||
| 4.7.0-0.okd-2021-06-13-090745 | ||
| 4.7.0-0.okd-2021-06-04-191031 | ||
| 4.7.0-0.okd-2021-05-22-050008 | ||
| 4.7.0-0.okd-2021-04-24-103438 | ||
| 4.7.0-0.okd-2021-04-11-124433 | ||
| ``` | ||
|
|
||
| ### Install version | ||
|
|
||
| ```bash | ||
| $ ocenv install 4.7.0-0.okd-2021-07-03-190901 | ||
| Downloading binary... | ||
| Done! Saving it at /home/user/.bin/oc-4.7.0-0.okd-2021-07-03-190901 | ||
| ``` | ||
|
|
||
| ### Use version | ||
|
|
||
| ```bash | ||
| $ ocenv use 4.7.0-0.okd-2021-07-03-190901 | ||
| Done! Using 4.7.0-0.okd-2021-07-03-190901 version. | ||
| ``` | ||
|
|
||
| ### Uninstall version | ||
|
|
||
| ```bash | ||
| $ ocenv uninstall 4.7.0-0.okd-2021-07-03-190901 | ||
| Done! 4.7.0-0.okd-2021-07-03-190901 version uninstalled from /home/ap/.bin/oc-4.7.0-0.okd-2021-07-03-190901. | ||
| ``` | ||
|
|
||
| ## License | ||
|
|
||
| GPL3 |
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,22 @@ | ||
| package main | ||
|
|
||
| import ( | ||
| "os" | ||
|
|
||
| "github.com/little-angry-clouds/kubernetes-binaries-managers/internal/cmd" | ||
| "github.com/mitchellh/go-homedir" | ||
| ) | ||
|
|
||
| var binaryDownloadURL string = "https://github.com/openshift/okd/releases/download/%s/openshift-client-%s-%s.tar.gz" // nolint:lll | ||
| var versionsAPI string = "https://api.github.com/repos/openshift/okd/releases?per_page=100&page=" // nolint:lll | ||
|
|
||
| func main() { | ||
| home, _ := homedir.Dir() | ||
| _ = os.MkdirAll(home+"/.bin", os.ModePerm) | ||
| cmd.BinaryDownloadURL = binaryDownloadURL | ||
| cmd.VersionsAPI = versionsAPI | ||
| cmd.BinaryToInstall = "oc" | ||
| cmd.RootCmd.Use = "ocenv" | ||
| cmd.RootCmd.Short = "OC version manager" | ||
| cmd.Execute() | ||
| } |
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
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
Oops, something went wrong.