diff --git a/CHANGELOG.md b/CHANGELOG.md index 2f0245c470..e7e0f15c2a 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -220,7 +220,7 @@ - The type name `TestCtx` in `pkg/test` has been deprecated and renamed to `Context`. It now exists only as a type alias to maintain backwards compatibility. Users of the e2e framework should migrate to use the new name, `Context`. The `TestCtx` alias will be removed in a future version. ([2549](https://github.com/operator-framework/operator-sdk/pull/2549)) - The additional of the dependency `inotify-tools` on Ansible based-operator images. ([#2586](https://github.com/operator-framework/operator-sdk/pull/2586)) -- **Breaking Change:** The scorecard feature now only supports YAML config files. So, any config file with other extension is deprecated and should be changed for the YAML format. For further information see [`scorecard config file`](./website/content/en/docs/scorecard/_index.md#config-file) ([#2591](https://github.com/operator-framework/operator-sdk/pull/2591)) +- **Breaking Change:** The scorecard feature now only supports YAML config files. So, any config file with other extension is deprecated and should be changed for the YAML format. For further information see [`scorecard config file`](./website/content/en/docs/advanced-topics/scorecard/_index.md#config-file) ([#2591](https://github.com/operator-framework/operator-sdk/pull/2591)) ### Removed @@ -465,7 +465,7 @@ ### Changed -- **Breaking Change:** New configuration format for the `operator-sdk scorecard` using config files. See [`doc/test-framework/scorecard`](./website/content/en/docs/scorecard/_index.md) for more info ([#1641](https://github.com/operator-framework/operator-sdk/pull/1641)) +- **Breaking Change:** New configuration format for the `operator-sdk scorecard` using config files. See [`doc/test-framework/scorecard`](./website/content/en/docs/advanced-topics/scorecard/_index.md) for more info ([#1641](https://github.com/operator-framework/operator-sdk/pull/1641)) - **Breaking change:** CSV config field `role-path` is now `role-paths` and takes a list of strings. Users can now specify multiple `Role` and `ClusterRole` manifests using `role-paths`. ([#1704](https://github.com/operator-framework/operator-sdk/pull/1704)) - Make `ready` package idempotent. Now, a user can call `Set()` or `Unset()` to set the operator's readiness without knowing the current state. ([#1761](https://github.com/operator-framework/operator-sdk/pull/1761)) @@ -534,7 +534,7 @@ - Unify CLI debug logging under a global `--verbose` flag ([#1361](https://github.com/operator-framework/operator-sdk/pull/1361)) - [Go module](https://github.com/golang/go/wiki/Modules) support by default for new Go operators and during Ansible and Helm operator migration. The dependency manager used for a new operator can be explicitly specified for new operators through the `--dep-manager` flag, available in [`operator-sdk new`](https://github.com/operator-framework/operator-sdk/blob/v0.8.0/doc/sdk-cli-reference.md#new) and [`operator-sdk migrate`](https://github.com/operator-framework/operator-sdk/blob/v0.8.0/doc/sdk-cli-reference.md#migrate). `dep` is still available through `--dep-manager=dep`. ([#1001](https://github.com/operator-framework/operator-sdk/pull/1001)) - New optional flag `--custom-api-import` for [`operator-sdk add controller`](https://github.com/operator-framework/operator-sdk/blob/v0.8.0/doc/sdk-cli-reference.md#controller) to specify that the new controller reconciles a built-in or external Kubernetes API, and what import path and identifier it should have. ([#1344](https://github.com/operator-framework/operator-sdk/pull/1344)) -- Operator Scorecard plugin support. Documentation for scorecard plugins can be found in the main scorecard [doc](./website/content/en/docs/scorecard/_index.md). ([#1379](https://github.com/operator-framework/operator-sdk/pull/1379)) +- Operator Scorecard plugin support. Documentation for scorecard plugins can be found in the main scorecard [doc](./website/content/en/docs/advanced-topics/scorecard/_index.md). ([#1379](https://github.com/operator-framework/operator-sdk/pull/1379)) ### Changed @@ -650,7 +650,7 @@ - Ansible operator proxy added the cache handler which allows the get requests to use the operators cache. [#760](https://github.com/operator-framework/operator-sdk/pull/760) - Ansible operator proxy added ability to dynamically watch dependent resource that were created by ansible operator. [#857](https://github.com/operator-framework/operator-sdk/pull/857) - Ansible-based operators have leader election turned on by default. When upgrading, add environment variable `POD_NAME` to your operator's Deployment using the Kubernetes downward API. To see an example, run `operator-sdk new --type=ansible ...` and see file `deploy/operator.yaml`. -- A new command [`operator-sdk scorecard`](https://github.com/operator-framework/operator-sdk/blob/v0.4.0/doc/sdk-cli-reference.md#scorecard) which runs a series of generic tests on operators to ensure that an operator follows best practices. For more information, see the [scorecard documentation](./website/content/en/docs/scorecard/_index.md) +- A new command [`operator-sdk scorecard`](https://github.com/operator-framework/operator-sdk/blob/v0.4.0/doc/sdk-cli-reference.md#scorecard) which runs a series of generic tests on operators to ensure that an operator follows best practices. For more information, see the [scorecard documentation](./website/content/en/docs/advanced-topics/scorecard/_index.md) ### Changed diff --git a/hack/generate/cli-doc/gen-cli-doc.go b/hack/generate/cli-doc/gen-cli-doc.go index fafb1cbd32..1b9e2346c9 100644 --- a/hack/generate/cli-doc/gen-cli-doc.go +++ b/hack/generate/cli-doc/gen-cli-doc.go @@ -39,12 +39,12 @@ func main() { log.Fatalf("Failed to get current directory: %v", err) } - legacyDocPath := filepath.Join(currentDir, "website", "content", "en", "docs", "cli") + legacyDocPath := filepath.Join(currentDir, "website", "content", "en", "docs", "cli", "ansible-helm") legacyRoot := cli.GetCLIRoot() legacyRoot.DisableAutoGenTag = true recreateDocDir(legacyRoot, legacyDocPath) - newDocPath := filepath.Join(currentDir, "website", "content", "en", "docs", "new-cli") + newDocPath := filepath.Join(currentDir, "website", "content", "en", "docs", "cli", "golang") _, newRoot := cli.GetPluginsCLIAndRoot() newRoot.DisableAutoGenTag = true recreateDocDir(newRoot, newDocPath) diff --git a/release.sh b/release.sh index b52a53d18d..bdaae16fb2 100755 --- a/release.sh +++ b/release.sh @@ -38,7 +38,7 @@ if [[ "$VER" != "$CURR_VER" ]]; then exit 1 fi -INSTALL_GUIDE_FILE="website/content/en/docs/install-operator-sdk.md" +INSTALL_GUIDE_FILE="website/content/en/docs/installation/install-operator-sdk.md" CURR_VER_INSTALL_GUIDE_FILE="$(sed -nr 's/.*RELEASE_VERSION=(.+)/\1/p' "$INSTALL_GUIDE_FILE" | tr -d ' \t\n')" if [[ "$VER" != "$CURR_VER_INSTALL_GUIDE_FILE" ]]; then echo "version '$VER' is not set correctly in $INSTALL_GUIDE_FILE" diff --git a/website/content/en/build/_index.html b/website/content/en/build/_index.html index 88bab7c648..96626520b2 100644 --- a/website/content/en/build/_index.html +++ b/website/content/en/build/_index.html @@ -24,14 +24,14 @@

How can I write an Operator with Operator

Installing the SDK CLI

-

Follow the steps in the installation guide to learn how to install the Operator SDK CLI tool. If you are using a release version of the SDK, make sure to follow the documentation for that version. You make use any of the following installation processes:

+

Follow the steps in the installation guide to learn how to install the Operator SDK CLI tool. If you are using a release version of the SDK, make sure to follow the documentation for that version. You make use any of the following installation processes:

    -
  1. Install the Homebrew (macOS)
    2. -
  2. Install from GitHub release
    3. -
  3. Compile and install from master
    4. +
  4. Install the Homebrew (macOS)
    5. +
  5. Install from GitHub release
    6. +
  6. Compile and install from master
- Learn More + Learn More @@ -44,19 +44,19 @@

Installing the SDK CLI

READ THE USER GUIDES

Operators can be created with the SDK using Ansible, Helm, or Go. Follow the one of the quickstart guides to dive in.