github.com/SamarSidharth/kpt@v0.0.0-20231122062228-c7d747ae3ace/site/reference/cli/alpha/rpkg/update/README.md (about) 1 --- 2 title: "`clone`" 3 linkTitle: "clone" 4 type: docs 5 description: > 6 Update a downstream package revision to a more recent revision of its upstream package. 7 --- 8 9 <!--mdtogo:Short 10 Update a downstream package revision to a more recent revision of its upstream package. 11 --> 12 13 `update` performs a kpt pkg update on an existing downstream package revision. 14 15 ### Synopsis 16 17 <!--mdtogo:Long--> 18 19 ``` 20 kpt alpha rpkg update PACKAGE_REV_NAME [flags] 21 ``` 22 23 #### Args 24 25 ``` 26 PACKAGE_REV_NAME: 27 The target downstream package revision to be updated. 28 29 ``` 30 31 #### Flags 32 33 ``` 34 --revision 35 The revision number of the upstream kpt package that the target 36 downstream package (PACKAGE_REV_NAME) should be updated to. With 37 this flag, you can only specify one target downstream package. 38 39 --discover 40 If set, list packages revisions that need updates rather than 41 performing an update. Must be one of 'upstream' or 'downstream'. If 42 set to 'upstream', this will list downstream package revisions that 43 have upstream updates available. If set to 'downstream', this will list 44 upstream package revisions whose downstream package revisions need 45 to be updated. You can optionally pass in package revision names as arguments 46 in order to just list updates for those package revisions, or you can 47 pass in no arguments in order to list available updates for all package 48 revisions. 49 50 ``` 51 52 <!--mdtogo--> 53 54 ### Examples 55 56 <!--mdtogo:Examples--> 57 58 ```shell 59 # update deployment-e982b2196b35a4f5e81e92f49a430fe463aa9f1a package to v3 of its upstream 60 $ kpt alpha rpkg update deployment-e982b2196b35a4f5e81e92f49a430fe463aa9f1a --revision=v3 61 ``` 62 63 ```shell 64 # see available upstream updates for all your downstream packages 65 $ kpt alpha rpkg update --discover=upstream 66 ``` 67 68 ```shell 69 # see available updates for any downstream packages that were created from the upstream blueprints-e982b2196b35a4f5e81e92f49a430fe463aa9f1a package 70 $ kpt alpha rpkg update --discover=downstream blueprints-e982b2196b35a4f5e81e92f49a430fe463aa9f1a 71 ``` 72 73 <!--mdtogo-->