github.com/wmuizelaar/kpt@v0.0.0-20221018115725-bd564717b2ed/site/reference/schema/plan/README.md (about)

     1  # Plan
     2  
     3  The `kpt alpha live plan` command gives the option of outputting the plan in KRM format. This will be wrapped in a `ResourceList` 
     4  resource so it can easily be piped into kpt functions for validation. 
     5  
     6  The plan contains a list of actions (under `spec.actions`) with one item for each resource associated with the package being 
     7  applied. Each entry in the list contains the `apiVersion`, `kind`, `name`, and `namespace` to identify the resource. It
     8  also contains an `action` field, which defines which action will be taken on the resource during apply. It can have one of
     9  the values:
    10  * **Create**: The resource does not currently exist in the cluster and will be created.
    11  * **Unchanged**: The resource exists in the cluster and there are no chnages to it.
    12  * **Delete**: The resource exists in the cluster, but is not among the applied resources. Therefore it will be pruned.
    13  * **Update**: The resource exists in the cluster and will be updated.
    14  * **Skip**: No changes will be made to this resource due to the presence of one or more lifecycle directives.
    15  * **Error**: An error was encountered for the resource.
    16  
    17  There is also an `original` field which contains the resource from the cluster before apply (is it does exist), and
    18  an `updated` field that contains the resource after apply (but the state in the cluster remains unchanged). Finally, there
    19  is an `error` field that will have a more detailed error message in the cases where the value of the `action` field is `Error`.
    20  
    21  The OpenAPI
    22  [schema is available here](https://raw.githubusercontent.com/GoogleContainerTools/kpt/main/site/reference/schema/kptfile/kptfile.yaml).