github.com/buildtool/build-tools@v0.2.29-0.20240322150259-6a1d0a553c23/www/docs/commands/promote.md (about)

     1  # promote
     2  
     3  Templates deployment descriptors and promotes them to a Git-repository of choice.
     4  Normal usage `promote <target>`, but additional flags can be used to override:
     5  
     6  |      Flag             |                   Description                                                   |
     7  | :-------------------- | :-------------------------------------------------------------------------------|
     8  | `--tag`               | Override the default tag to use (instead of the current commit tag or the value from CI) |
     9  | `--url`               | override the URL to the Git repository where files will be generated |
    10  | `--path`              | override the path in the Git repository where files will be generated |
    11  | `--user`              | username for Git access, defaults to `git` |
    12  | `--key`               | private key for Git access, defaults to `~/.ssh/id_rsa` |
    13  | `--password`          | password for private key, defaults to `""` |
    14  | `--out` , `-o`        | write output to specified file instead of committing and pushing to Git |
    15  
    16  
    17  ## Default usage, with `.buildtools.yaml` file
    18  Only the `target` name has to be specified
    19  ```sh
    20  $ promote local
    21  ```
    22  
    23  ### Generate file locally:
    24  ```sh
    25  $ promote --out out.yaml local
    26  ```