More than 1 year has passed since last update.

kubectl applyなどを使用しないIBM Cloudでの最小限Tekton Pipeline構成実行

Last updated at 2022-03-27Posted at 2022-03-23

備忘

IBM Cloudで最小限のTekton Pipelineを構成してみる。
おそらく無料のプランで実現可能。

前提

Gitとssh clientが使用可能なインターネットに接続されたローカル環境 (Fedora Linux 35にて確認)
IBM Cloudのユーザー登録

ローカルでの用意

IBM Cloud上のGitlabを使用する為のssh接続設定

IBM Cloud上のGitlabを使用する為の接続情報を設定する。
なお、これは必須ではなく、GithubやGitlabなども利用可能。

ここではIBM Cloudのユーザー名はgaf01112とする。
SSHキーがなければ用意し、jp-tok.git.cloud.ibm.comへの接続時にユーザーをIBM Cluodのユーザーとしておく。
必要に応じて、専用のキーを利用するなど変更する。

$ [[ -f ~/.ssh/id_rsa ]] || ssh-keygen -N '' -C ''
...

$ cat <<__EOC__ >> ~/.ssh/config
Host jp-tok.git.cloud.ibm.com
  User gaf01112
  IdentityFile ~/.ssh/id_rsa
__EOC__

Tektonマニフェストの用意

tekton-pipeline-01ディレクトリー下をリポジトリーとする。
IBM Clouldでのデフォルトなので、.tektonにマニフェストを置くが、他でも指定可能。

$ mkdir -p tekton-pipeline-01/.tekton
$ cd tekton-pipeline-01/.tekton

タスク定義マニフェスト

2ステップのタスクを用意する。
タスク内のステップは順番に実行される。
各ステップはコンテナであり、タスクはPODに相当。
ステップ間で/workspaceなどが共有される。

例えばイメージにgit,terraform,ansibleなどのイメージを指定すれば、インフラ操作を、それらの製品をコントローラーに導入することなく実行可能。

tekton-pipeline-01/.tekton/task-hello.yaml

apiVersion: tekton.dev/v1beta1
kind: Task
metadata:
  name: task-hello
spec:
  steps:
    - name: step-hello1
      image: docker.io/alpine:3.15.1
      script: |
        #! /usr/bin/env bash
        set -ex
        grep PRETTY /etc/os-release
        echo hello > /workspace/msg
    - name: step-hello2
      image: registry.access.redhat.com/ubi8:8.5-236.1647448331
      script: |
        #! /usr/bin/env bash
        set -ex
        grep PRETTY /etc/os-release
        cat /workspace/msg

パイプライン定義マニフェスト

1タスクのみ定義。

tekton-pipeline-01/.tekton/pipeline-hello.yaml

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

EventListenerとTriggerTemplateを定義

実行のトリガーを待つEventListenerと、EventListenerから呼び出すパイプラインを定義するTriggerTemplateを設定する。
IBM Cloud上では、このEventListenerを呼び出すことによりpipelineRunする。

tekton-pipeline-01/.tekton/eventlistener.yaml

apiVersion: triggers.tekton.dev/v1beta1
kind: TriggerTemplate
metadata:
  name: template-pipelinerun-hello
spec:
  resourcetemplates:
    - apiVersion: tekton.dev/v1beta1
      kind: PipelineRun
      metadata:
        generateName: pipeline-hello-run-
      spec:
        pipelineRef:
          name: pipeline-hello
---
apiVersion: triggers.tekton.dev/v1beta1
kind: EventListener
metadata:
  name: listener1
spec:
  triggers:
    - bindings:
        - name: message
          value: Hello from the Triggers EventListener!
      template:
        ref: template-pipelinerun-hello

https://tekton.dev/docs/triggers/eventlisteners/
https://tekton.dev/docs/triggers/triggertemplates/

IBM Cloudでの設定

IBM Cloudにログイン（予めユーザーを作成してある前提）

ログイン後のダッシュボード画面

左上角の「Navigation Menu」ボタンを選択し、現れた左列のサブメニューにおいて「DevOps」をクリック

ツールチェーンの作成

左列が「ツールチェーン」であることを確認し、「ツールチェーンの作成」ボタンをクリック（どちらのボタンでも良い)
ここでは、リソースグループやロケーションはそのままで作成。

ツールチェーンの作成メニューとなる
表の下の方にある「Build your own ツールチェーン」をクリック

「作成」をクリック
なお、ツールチェーン名は、ここでは入力されていた値を使用しているが、ユーザーで指定可能。

空のツールチェーンが作成される

ツールチェーンにGitリポジトリーを追加

右上の「ツールの追加」ボタンをクリック

Gitのリポジトリーサービスとして、ここではIBM Cloudで提供しているGitLabである「Git リポジトリーおよびIssueトラッキング」をクリックし、プライベートリポジトリーとして使用する。
「GitHub」や「GitLab」を選択、使用してもよい。

ここでは新規に作成とする。
リポジトリー名はユーザーによる指定。
リポジトリー所有者はIBM Cluodのユーザー。
「統合の作成」をクリック

sshキーが未設定の場合、上の「Add SSH key」より設定可能。

keyには~/.ssh/id_rsa.pubの内容を記載。(画面のキーの値はダミー)
TitleとExpiration dateは適当に。
「Add Key」ボタンをクリック

ローカルに戻ってGit push

まだ行っていなければ画面下方のGit global setupにガイドされているgit config --globalを実行

その後、Push an existing folderにガイドされているgit init, add, commit, pushを実行

$ cd ..

$ ls -a
.  ..  .tekton

$ git init --initial-branch=main
...

$ git remote add origin git@jp-tok.git.cloud.ibm.com:<USERNAME>/tekton-pipeline-01.git

$ git add .

$ git commit -m "Initial commit"
...

$ git push -u origin main
...