Metadata-Version: 2.1
Name: tektonbundle
Version: 0.3.0
Summary: This willl take a bunch of tekton templates resource and compile it as a single entity, Pipelinerun.
Home-page: https://github.com/chmouel/tektonbundle
Author: Chmouel Boudjnah
Author-email: chmouel@chmouel.com
License: MIT license
Keywords: tektonbundle
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Requires-Python: >=3.5
Description-Content-Type: text/markdown

# Tekton resources Bundle

[![Codecov](https://img.shields.io/codecov/c/github/chmouel/tektonbundle/master.svg?style=flat-square)](https://codecov.io/gh/chmouel/tektonbundle)  [![License](https://img.shields.io/pypi/l/tektonbundle.svg?)](https://pypi.python.org/pypi/tektonbundle) [![PYPI](https://img.shields.io/pypi/v/tektonbundle.svg?style=flat-square)](https://pypi.python.org/pypi/tektonbundle)

A CLI to go over a bunch of Tekton yaml resources and bundle them as one in a `Pipelinerun` and `pipelineSpec`/`taskSpec`.
It optionally can get argument to replace in tempalates.

## Install

```shell
pip3 install tektonbundle
```

and you are good to go!

`pyyaml` is really the external depencences here.

## Usage

You only need to point the tool to some yaml files or a directory where it will
collect every `.yaml` or `.yml` files in there and analyze them. It will then
output the 'bundled' yaml file which you can pipe to `kubectl create`, i.e:

```shell
tektonbundle "/path/to/directory"|kubectl create -f-
```

Full help of the CLI is :

```
usage: tektonbundle [-h] [--skip-inlining SKIP_INLINING] [--only-bundled]
                    files [files ...] [parameters [parameters ...]]

positional arguments:
  files                 Files and/or directories where to get all the yaml files.
  parameters            Add parameters to pass to templates.

optional arguments:
  -h, --help            show this help message and exit
  --skip-inlining SKIP_INLINING
                        Skip inlining these tasks, you can add many of them separated by a comma.
  --only-bundled        Print only the files that have been bundled (tekton files) and skip others.
```

## Description

If you have a Pipelinerun that looks like this :

```yaml
---
apiVersion: tekton.dev/v1beta1
kind: Pipelinerun
metadata:
    name: pipeline-run
spec:
    pipelineRef:
        name: pipeline
```

and a `Pipeline` named pipeline1 that looks like this :

```yaml
---
apiVersion: tekton.dev/v1beta1
kind: Pipeline
metadata:
    name: pipeline
spec:
    tasks:
    - name: task
      taskRef:
        name: task
```

and finally a task that looks like this :

```yaml
---
apiVersion: tekton.dev/v1beta1
kind: Task
metadata:
  name: task
spec:
  steps:
    - name: step
      image: scratch
```

It will 'bundle' everything as one, using `pipelineSpec` and `taskSpec`:

```yaml
apiVersion: tekton.dev/v1beta1
kind: PipelineRun
metadata:
  generateName: pipeline-run-
spec:
  pipelineSpec:
    tasks:
    - name: task
      taskSpec:
        steps:
        - image: scratch
          name: step
```

It will change the `name` as `generateName` to be unique.

You can skip some tasks to be inlined and be kept as referenced, you only have
to specify the switch `--skip-inlining` with the name of the task to be
skipped. You can add multiple of them separated by comma, i.e:
`--skip-inlining=task1,task2`

By default `tektonbundle` will print every yaml files from the directory or
files you have given even those that are not bundled (i.e: non tekton files). If
you don't want this behavior you can add the option `--only-bundled` and it will
only print the 'bundle' file.

## Substition support via parameters.

`tektonbundle` support simple template substitions if you need to specify some value before applying.

If you have the string `key: {{value}}` in your template (no spaces in between).

And you launch the CLI with this arguments :

```shell
tektonbundle /path/to/dir value="hello"
```

The value of the template would be substited with the value you have provided.

If no value has been provided, it will be kept as is (you will end up with a `key: {{value}}` in your template).


=======
History
=======

0.3.0 (2020-12-11)
------------------

Print ignored files too
Allow passing files instead of just directory

0.1.0 (2020-10-20)
------------------

* First release on PyPI.


