Update README.md

This commit is contained in:
Jeff Regan
2021-04-02 17:34:22 -07:00
committed by GitHub
parent 629fdee26a
commit ed688a87e4

View File

@@ -15,7 +15,7 @@
This document describes how to perform a [semver release] This document describes how to perform a [semver release]
of one of the several [Go modules] in this repository. of one of the several [Go modules] in this repository.
### Release sequence ## Release sequence
The dependencies determine the release order: The dependencies determine the release order:
@@ -40,6 +40,8 @@ kustomize openapi info
Instructions on how to get a new OpenAPI sample can be found in the Instructions on how to get a new OpenAPI sample can be found in the
[OpenAPI Readme]. [OpenAPI Readme].
## Prep work
#### Make some helper functions #### Make some helper functions
``` ```
@@ -86,7 +88,7 @@ function testKustomizeRepo {
( cd cmd/gorepomod; go install . ) ( cd cmd/gorepomod; go install . )
``` ```
#### Authenticate to github using [gh](https://github.com/cli/cli) #### Authenticate to github using [gh](https://github.com/cli/cli) (version [1.8.1](https://github.com/cli/cli/releases/tag/v1.8.1) or higher).
``` ```
# Use your own token # Use your own token
@@ -95,6 +97,8 @@ GITHUB_TOKEN=deadbeefdeadbeef
echo $GITHUB_TOKEN | gh auth login --scopes repo --with-token echo $GITHUB_TOKEN | gh auth login --scopes repo --with-token
``` ```
## Release `kyaml`
#### Establish clean state #### Establish clean state
``` ```
@@ -103,7 +107,10 @@ refreshMaster
testKustomizeRepo testKustomizeRepo
``` ```
#### Release `kyaml` kyaml has no intra-repo deps, so if the tests pass,
it can just be released.
Release it:
``` ```
gorepomod release kyaml --doIt gorepomod release kyaml --doIt
@@ -118,8 +125,7 @@ Undraft the release on the [kustomize repo release page],
make sure the version number is what you expect. make sure the version number is what you expect.
#### Release [`cli-utils`](https://github.com/kubernetes-sigs/cli-utils) ## Release [`cli-utils`](https://github.com/kubernetes-sigs/cli-utils)
``` ```
cd ../cli-utils cd ../cli-utils
@@ -161,7 +167,7 @@ Note the version:
versionCliUtils=v0.22.4 # EDIT THIS! versionCliUtils=v0.22.4 # EDIT THIS!
``` ```
#### Release `cmd/config` ## Release `cmd/config`
``` ```
cd ../kustomize cd ../kustomize
@@ -226,7 +232,9 @@ Undraft the release on the [kustomize repo release page],
make sure the version number is what you expect. make sure the version number is what you expect.
#### Release `api` (the kustomize API, used by the CLI) ## Release `api`
This is the kustomize API, used by the kustomize CLI.
Pin to the new cmd/config: Pin to the new cmd/config:
@@ -273,7 +281,7 @@ Undraft the release on the [kustomize repo release page],
make sure the version number is what you expect. make sure the version number is what you expect.
#### Release the kustomize CLI ## Release the kustomize CLI
Pin to the new API: Pin to the new API:
``` ```
@@ -311,19 +319,19 @@ gorepomod release kustomize --doIt
Undraft the release on the [kustomize repo release page]. Undraft the release on the [kustomize repo release page].
### Important ## Confirm the kustomize binary is correct
[installation instructions]: https://kubectl.docs.kubernetes.io/installation/kustomize/binaries/ > [installation instructions]: https://kubectl.docs.kubernetes.io/installation/kustomize/binaries/
>
* Follow the [installation instructions] to install your new > * Follow the [installation instructions] to install your new
releas and make sure it reports the expected version number. > release and make sure it reports the expected version number.
>
If not, something is very wrong. > If not, something is very wrong.
>
* Visit the [release page] and edit the release notes as desired. > * Visit the [release page] and edit the release notes as desired.
#### Unpin everything ## Unpin everything
Go back into development mode, where all modules depend on in-repo code: Go back into development mode, where all modules depend on in-repo code: