😽 yumenomatayume.log

2022-10-03
daggercicddocker

Dagger のチュートリアルを試してみる

CI/CD パイプラインツールである Dagger のチュートリアルを試してみます。

インストール

まずは CLI をインストールします。asdf でインストールしました。

❯ asdf plugin-add dagger
❯ asdf install dagger latest
Downloading dagger from https://github.com/dagger/dagger/releases/download/v0.2.34/dagger_v0.2.34_darwin_arm64.tar.gz
❯ asdf global dagger latest
❯ dagger version
dagger 0.2.35 (00cde7521) darwin/arm64
チュートリアル

とりあえずチュートリアルを実施していき、Dagger の使用感を掴みたいと思います。

Build, run and test locally

ローカル環境で実行します。

❯ git clone https://github.com/dagger/todoapp

❯ cd todoapp

❯ dagger project update
1:45PM INFO  system | installing all packages...
1:45PM INFO  system | installed/updated package universe.dagger.io@0.2.34
1:45PM INFO  system | installed/updated package dagger.io@0.2.34

❯ dagger do build
[✔] actions.build.install.container.script                                                                                                                                                                                                                                  0.5s
[✔] actions.build.container                                                                                                                                                                                                                                               360.2s
[✔] actions.source                                                                                                                                                                                                                                                          5.7s
[✔] actions.build.install.container                                                                                                                                                                                                                                       130.8s
[✔] actions.build.container.script                                                                                                                                                                                                                                          0.5s
[✔] actions.build.install.container.export                                                                                                                                                                                                                                  1.5s
[✔] actions.build.container.export                                                                                                                                                                                                                                          1.8s
[✔] client.filesystem."./build".write                                                                                                                                                                                                                                       1.3s
Field  Value
logs   """\n  yarn run v1.22.17\n  $ react-scripts build\n  Creating an optimized production build...\n  Compiled with warnings.\n\n  ./src/App.js\n    Line 110:7:  The element ul has an implicit role of list. Defining this explicitly is redundant and should be avoided  jsx-a11y/no-redundant-roles\n\n  Search for the keywords to learn more about each warning.\n  To ignore, add // eslint-disable-next-line to the line before.\n\n  File sizes after gzip:\n\n    40.12 KB  build/static/js/2.a228fa91.chunk.js\n    1.55 KB   build/static/js/main.af3de9df.chunk.js\n    1.46 KB   build/static/css/main.9149988f.chunk.css\n    782 B     build/static/js/runtime-main.89495321.js\n\n  The project was built assuming it is hosted at ./.\n  You can control this with the homepage field in your package.json.\n\n  The build folder is ready to be deployed.\n\n  Find out more about deployment here:\n\n    bit.ly/CRA-deploy\n\n  Done in 214.92s.\n\n  """

静的ファイルを build しました。

open build/index.html で HTML ファイルを開くと、ブラウザで ToDo App が表示されます。

画像が読み込まれない場合はページを更新してみてください。

静的ファイルの build には dagger do build コマンドを用いますが、テスト実行は dagger do test 、（netlify への）デプロイには dagger do deploy コマンドが用意されています。

この dagger do コマンドの引数は Dagger Actions と呼ばれるもので、ユーザーが独自で定義できるアクションとなっております。dagger.cue ファイルに設定を記述します。

また、dagger do —help コマンドから実行可能な引数を確認できます。

dagger do --help 
❯ dagger do --help
Usage:
  dagger do <action> [subaction...] [flags]

Options


Available Actions:
 source Load the todoapp source code
 build  Build todoapp
 test   Test todoapp
 deploy Deploy todoapp


Flags:
      --cache-from stringArray   External cache sources (eg. user/app:cache, type=local,src=path/to/dir)
      --cache-to stringArray     Cache export destinations (eg. user/app:cache, type=local,dest=path/to/dir)
      --dry-run                  Dry run mode
  -h, --help                     help for do
      --no-cache                 Disable caching
      --output string            File path to write the action's output values. Prints to stdout if empty
      --output-format string     Format for output values (plain, json, yaml)
  -p, --plan string              Path to plan (defaults to current directory) (default ".")
      --platform string          Set target build platform (requires experimental)
      --telemetry-log            Send telemetry logs to file (requires experimental)
  -w, --with stringArray

Global Flags:
      --experimental        Enable experimental features
      --log-format string   Log format (auto, plain, tty, json) (default "auto")
  -l, --log-level string    Log level (default "info")
Integrate with your CI environment

Dagger は主要な CI/CD サービスに対応しています。公式サイトに各 CI/CD サービスのサンプルが記載されています。

ローカル環境で実行したコマンドをそのまま CI に入れたり、プロダクション用に CD を実行したりと、Dagger の設定ファイルのみに柔軟にカスタマイズできるのが魅力です。

GitHub Actions
name: todoapp

on:
  push:
    # Trigger this workflow only on commits pushed to the main branch
    branches:
      - main

# Dagger plan gets configured via client environment variables
env:
  # This needs to be unique across all of netlify.app
  APP_NAME: todoapp-dagger-europa
  NETLIFY_TEAM: dagger

jobs:
  dagger:
    runs-on: ubuntu-latest
    steps:
      - name: Clone repository
        uses: actions/checkout@v2

      # You need to run `dagger project init` locally before and commit the cue.mod directory to the repository with its contents
      - name: Deploy to Netlify
        uses: dagger/dagger-for-github@v3
        # See all options at https://github.com/dagger/dagger-for-github
        with:
          version: 0.2
          # To pin external dependencies, you can use `project update github.com/[package-source]@v[n]`
          cmds: |
            project update
            do deploy
        env:
          # Get one from https://app.netlify.com/user/applications/personal
          NETLIFY_TOKEN: ${{ secrets.NETLIFY_TOKEN }}
GitLab
.docker:
  image: docker:${DOCKER_VERSION}-git
  services:
    - docker:${DOCKER_VERSION}-dind
  variables:
    # See https://docs.gitlab.com/ee/ci/docker/using_docker_build.html#docker-in-docker-with-tls-enabled-in-the-docker-executor
    DOCKER_HOST: tcp://docker:2376

    DOCKER_TLS_VERIFY: "1"
    DOCKER_TLS_CERTDIR: "/certs"
    DOCKER_CERT_PATH: "/certs/client"

    # Faster than the default, apparently
    DOCKER_DRIVER: overlay2

    DOCKER_VERSION: "20.10"

.dagger:
  extends: [.docker]
  variables:
    DAGGER_VERSION: 0.2.25
    DAGGER_LOG_FORMAT: plain
    DAGGER_CACHE_PATH: .dagger-cache

    ARGS: ""
  cache:
    key: dagger-${CI_JOB_NAME}
    paths:
      - ${DAGGER_CACHE_PATH}
  before_script:
    - |
      # install dagger
      cd /usr/local
      wget -O - https://dl.dagger.io/dagger/install.sh | sh
      cd -

      dagger version
  script:
    - dagger project update
    - |
      dagger \
          do \
          --cache-from type=local,src=${DAGGER_CACHE_PATH} \
          --cache-to type=local,mode=max,dest=${DAGGER_CACHE_PATH} \
          ${ARGS}

build:
  extends: [.dagger]
  variables:
    ARGS: build

実際に CI/CD サービスと連携したチュートリアルは実施しませんが、ローカル環境で試したパイプラインを CI/CD サービスに適用することが容易であることはお分かりいただけたと思います。

終わりに

これまでは、ローカル環境でもテストを実行したい場合は Makefile で処理をまとめていたのですが、Dagger を導入すれば解決できそうです。

Dagger の動作や設定などについては、自身の Scrapbox にメモしていきます。

新しく CI/CD を作成する際は、試しに Dagger で作ってみようかなと思いました。

何か作ったら記事を書こうとおもいます。

Reference（参考）
👍

Posts in the same category

There are no contents yet

Recommended

Latest posts

Categories