$ kubectl apply -f cronjob.batch.v1beta1.yaml
Warning: batch/v1beta1 CronJob is deprecated in v1.21+, unavailable in v1.25+; use batch/v1 CronJob
cronjob.batch/hello created

apiVersion: apps/v1
kind: Deployment
metadata:
  name: example
  namespace: example

$ kubectl api-versions

$ kubectl api-resources

type apiLifecycleDeprecated interface {
	APILifecycleDeprecated() (major, minor int)
}

type apiLifecycleRemoved interface {
	APILifecycleRemoved() (major, minor int)
}

type apiLifecycleReplacement interface {
	APILifecycleReplacement() schema.GroupVersionKind
}

// APILifecycleDeprecated is an autogenerated function, returning the release in which the API struct was or will be deprecated as int versions of major and minor for comparison.
// It is controlled by "k8s:prerelease-lifecycle-gen:deprecated" tags in types.go or  "k8s:prerelease-lifecycle-gen:introduced" plus three minor.
func (in *CronJob) APILifecycleDeprecated() (major, minor int) {
	return 1, 21
}

// APILifecycleReplacement is an autogenerated function, returning the group, version, and kind that should be used instead of this deprecated type.
// It is controlled by "k8s:prerelease-lifecycle-gen:replacement=<group>,<version>,<kind>" tags in types.go.
func (in *CronJob) APILifecycleReplacement() schema.GroupVersionKind {
	return schema.GroupVersionKind{Group: "batch", Version: "v1", Kind: "CronJob"}
}

// APILifecycleRemoved is an autogenerated function, returning the release in which the API is no longer served as int versions of major and minor for comparison.
// It is controlled by "k8s:prerelease-lifecycle-gen:removed" tags in types.go or  "k8s:prerelease-lifecycle-gen:deprecated" plus three minor.
func (in *CronJob) APILifecycleRemoved() (major, minor int) {
	return 1, 25
}

deprecated = deprecation.IsDeprecated(versionedPtrWithGVK, currentMajor, currentMinor)
if deprecated {
	removedRelease = deprecation.RemovedRelease(versionedPtrWithGVK)
	warnings = append(warnings, deprecation.WarningMessage(versionedPtrWithGVK))
}

// IsDeprecated returns true if obj implements APILifecycleDeprecated() and returns
// a major/minor version that is non-zero and is <= the specified current major/minor version.
func IsDeprecated(obj runtime.Object, currentMajor, currentMinor int) bool {
	deprecated, isDeprecated := obj.(apiLifecycleDeprecated)
	if !isDeprecated {
		return false
	}

	deprecatedMajor, deprecatedMinor := deprecated.APILifecycleDeprecated()
	// no deprecation version expressed
	if deprecatedMajor == 0 && deprecatedMinor == 0 {
		return false
	}
	// no current version info available
	if currentMajor == 0 && currentMinor == 0 {
		return true
	}
	// compare deprecation version to current version
	if deprecatedMajor > currentMajor {
		return false
	}
	if deprecatedMajor == currentMajor && deprecatedMinor > currentMinor {
		return false
	}
	return true
}

// WarningMessage returns a human-readable deprecation warning if the object implements APILifecycleDeprecated()
// to indicate a non-zero deprecated major/minor version and has a populated GetObjectKind().GroupVersionKind().
func WarningMessage(obj runtime.Object) string {
	deprecated, isDeprecated := obj.(apiLifecycleDeprecated)
	if !isDeprecated {
		return ""
	}

	deprecatedMajor, deprecatedMinor := deprecated.APILifecycleDeprecated()
	if deprecatedMajor == 0 && deprecatedMinor == 0 {
		return ""
	}

	gvk := obj.GetObjectKind().GroupVersionKind()
	if gvk.Empty() {
		return ""
	}
	deprecationWarning := fmt.Sprintf("%s %s is deprecated in v%d.%d+", gvk.GroupVersion().String(), gvk.Kind, deprecatedMajor, deprecatedMinor)

	if removed, hasRemovalInfo := obj.(apiLifecycleRemoved); hasRemovalInfo {
		removedMajor, removedMinor := removed.APILifecycleRemoved()
		if removedMajor != 0 || removedMinor != 0 {
			deprecationWarning = deprecationWarning + fmt.Sprintf(", unavailable in v%d.%d+", removedMajor, removedMinor)
		}
	}

	if replaced, hasReplacement := obj.(apiLifecycleReplacement); hasReplacement {
		replacement := replaced.APILifecycleReplacement()
		if !replacement.Empty() {
			deprecationWarning = deprecationWarning + fmt.Sprintf("; use %s %s", replacement.GroupVersion().String(), replacement.Kind)
		}
	}

	return deprecationWarning
}

// +k8s:prerelease-lifecycle-gen:deprecated=1.21
// +k8s:prerelease-lifecycle-gen:removed=1.25
// +k8s:prerelease-lifecycle-gen:replacement=batch,v1,CronJob

$ pluto detect-files -o wide
NAME       NAMESPACE   KIND                  VERSION              REPLACEMENT            DEPRECATED   DEPRECATED IN   REMOVED   REMOVED IN   REPL AVAIL   REPL AVAIL IN
grpc-alb   examples    Ingress               extensions/v1beta1   networking.k8s.io/v1   true         v1.14.0         true      v1.22.0      true         v1.19.0
grpc-alb   examples    PodDisruptionBudget   policy/v1beta1       policy/v1              true         v1.21.0         true      v1.25.0      true         v1.21.0

A tool to detect Kubernetes apiVersions

Usage:
  pluto [flags]
  pluto [command]

Available Commands:
  completion            Generate the autocompletion script for the specified shell
  detect                Checks a single file or stdin for deprecated apiVersions.
  detect-all-in-cluster run all in-cluster detections
  detect-api-resources  detect-api-resources
  detect-files          detect-files
  detect-helm           detect-helm
  help                  Help about any command
  list-versions         Outputs a JSON object of the versions that Pluto knows about.
  version               Prints the current version of the tool.

Flags:
  -f, --additional-versions string        Additional deprecated versions file to add to the list. Cannot contain any existing versions
      --columns strings                   A list of columns to print. Mandatory when using --output custom, optional with --output markdown
      --components strings                A list of components to run checks for. If nil, will check for all found in versions.
  -h, --help                              help for pluto
      --ignore-deprecations               Ignore the default behavior to exit 2 if deprecated apiVersions are found.
      --ignore-removals                   Ignore the default behavior to exit 3 if removed apiVersions are found.
      --ignore-unavailable-replacements   Ignore the default behavior to exit 4 if deprecated but unavailable apiVersions are found.
      --no-footer                         Disable footer output
  -H, --no-headers                        When using the default or custom-column output format, don't print headers (default print headers).
  -r, --only-show-removed                 Only display the apiVersions that have been removed in the target version.
  -o, --output string                     The output format to use. (normal|wide|custom|json|yaml|markdown|csv) (default "normal")
  -t, --target-versions stringToString    A map of targetVersions to use. This flag supersedes all defaults in version files. (default [])
  -v, --v Level                           number for the log level verbosity

Use "pluto [command] --help" for more information about a command.

$ pluto detect-files -d . -o wide --target-versions k8s=v1.29.0 2>/dev/null

$ pluto detect-helm -o wide --target-versions k8s=v1.29.0 2>/dev/null

$ kustomize build . --enable-helm | pluto detect --target-versions version=v1.29.0 - 2>/dev/null

$ pluto detect-api-resources -o wide --target-versions k8s=v1.29.0 2>/dev/null

$ pluto detect-all-in-cluster -o wide --target-versions k8s=v1.29.0 2>/dev/null

name: pluto

on:
  push:
    branches:
      - test/pluto
  pull_request:
    branches:
      - main

jobs:
  pluto:
    name: pluto
    runs-on: ubuntu-latest

    steps:
      - name: Checkout
        uses: actions/checkout@v3
        with:
          fetch-depth: 0

      - name: Download Pluto
        uses: FairwindsOps/pluto/github-action@master

      - name: Run Pluto
        id: pluto
        run: |
          echo 'content<<EOF' >> $GITHUB_ENV
          pluto detect-files --target-versions k8s=v1.29.0 -o json | jq >> $GITHUB_ENV
          echo 'EOF' >> $GITHUB_ENV

          # exit status を元に後続の step を実行
          pluto detect-files

      - uses: mshick/add-pr-comment@v1
        if: failure()
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        with:
          message: |
            ## Pluto detect deprecation/removal
            Fix from the documents below.
            [Kubernetes | Deprecated API Migration Guide](https://kubernetes.io/docs/reference/using-api/deprecation-guide/)
            ```json
            ${{ env.content }}
            ```
          repo-token: ${{ secrets.GITHUB_TOKEN }}
          repo-token-user-login: 'github-actions[bot]'
          allow-repeats: false