GitLab CI/CD で MinIO にファイルを公開する

GitLab CI/CD は GitLab をベースにした継続的インテグレーション・継続的デリバリーのサービスで、コードをコミットするたびにコンパイル、テスト、パッケージング、デプロイといった一連のタスクを自動で実行してくれます。MinIO は高性能なオブジェクトストレージサービスで、Amazon S3 互換の API を提供し、分散構成、耐障害性、暗号化などの機能をサポートしています。本記事では、GitLab CI/CD を使って生成したファイルを MinIO に公開し、シンプルで効率的な自動化フローを実現する方法を紹介します。

前提条件

  • GitLab のアカウントを持ち、プロジェクトを作成またはインポートしていること
  • MinIO のアカウントを持ち、バケット(Bucket)とアクセスキー(Access Key と Secret Key)を作成または取得していること
  • プロジェクトのルートディレクトリに、GitLab CI/CD の設定を定義する .gitlab-ci.yml ファイルを作成すること

Gitlab CI/CD の設定方法

Gitlab CI/CD で MinIO オブジェクトストレージにファイルを自動公開するには、次の手順が必要です:

  1. プロジェクトのルートディレクトリに .gitlab-ci.yml ファイルを作成します。これは Gitlab CI/CD のフローとタスクを定義する宣言型のファイルです。
  2. .gitlab-ci.yml ファイルに、ファイルを公開する処理を実行する deploy ステージを定義します。
  3. deploy ステージで、mc コマンドラインツールまたはその他の MinIO クライアントツールを使って MinIO オブジェクトストレージにファイルをアップロードします。
  4. deploy ステージで、MinIO のアドレス、キー、バケット名などの環境変数を設定します。
  5. プロジェクト設定で Gitlab CI/CD を有効にし、対応する環境変数を追加します。

ここでは、プロジェクトにすでにビルドスクリプトがあり、dist/ ディレクトリが生成されていることを前提とします。そうでない場合は、ご自身のプロジェクトに合わせて調整してください。

また、プロジェクト設定に次の 3 つの環境変数を追加する必要があります:

  • MINIO_URL: MinIO のアドレス。例:http://localhost:9000
  • MINIO_ACCESS_KEY: MinIO のアクセスキー
  • MINIO_SECRET_KEY: MinIO のアクセスキー

これらの環境変数はプロジェクト設定 -> CI/CD -> Variables で追加でき、保護やマスクを行うかどうかも選択できます。

以下は .gitlab-ci.yml ファイルの例です:

stages:
  - deploy

before_script:
  - curl https://dl.min.io/client/mc/release/linux-amd64/mc -o mc  # 下载并安装 MinIO 客户端
  - chmod +x mc  # 赋予可执行权限

master-deploy:
  stage: deploy
  only:
    - master # 只有master更新的时候才执行命令
  script: # 执行的命令
    - ./mc config host add minio $MINIO_URL $MINIO_ACCESS_KEY $MINIO_SECRET_KEY # 设置 MinIO 别名和认证信息
    - ./mc cp dist/ minio/<bucket-name>/<project-name>/ # 将 dist 目录下的所有文件复制到 MinIO 的指定存储桶和目录下

このファイルでは deploy ステージを 1 つ定義しています

  • before_script で MinIO クライアントをダウンロードし、実行権限を付与しています。
  • 続いて実行されるコマンドのうち、1 つ目で MinIO のアドレスとキーを設定しています。
  • 2 つ目のコマンドで、プロジェクトのビルド後に生成された dist/ ディレクトリ内のすべてのファイルを MinIO の指定バケットにコピーしています。

結果の確認方法

コードをコミットすると、Gitlab CI/CD が自動的にトリガーされ、.gitlab-ci.yml ファイルに定義されたタスクが実行されます。プロジェクトページ -> CI/CD -> Pipelines で、フローのステータスとログを確認できます。