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 オブジェクトストレージにファイルを自動公開するには、次の手順が必要です:
- プロジェクトのルートディレクトリに
.gitlab-ci.ymlファイルを作成します。これは Gitlab CI/CD のフローとタスクを定義する宣言型のファイルです。 .gitlab-ci.ymlファイルに、ファイルを公開する処理を実行するdeployステージを定義します。deployステージで、mcコマンドラインツールまたはその他の MinIO クライアントツールを使って MinIO オブジェクトストレージにファイルをアップロードします。deployステージで、MinIO のアドレス、キー、バケット名などの環境変数を設定します。- プロジェクト設定で Gitlab CI/CD を有効にし、対応する環境変数を追加します。
ここでは、プロジェクトにすでにビルドスクリプトがあり、dist/ ディレクトリが生成されていることを前提とします。そうでない場合は、ご自身のプロジェクトに合わせて調整してください。
また、プロジェクト設定に次の 3 つの環境変数を追加する必要があります:
MINIO_URL: MinIO のアドレス。例:http://localhost:9000MINIO_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 で、フローのステータスとログを確認できます。