正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。

SMTP Rakeタスク

  • プラン: Free、Premium、Ultimate
  • 提供形態: GitLab Self-Managed

以下は、SMTP関連のRakeタスクです。

シークレット

GitLabは、暗号化されたファイルから読み取るために、SMTP設定シークレットを使用できます。次のRakeタスクは、暗号化されたファイルの内容を更新するために提供されています。

シークレットを表示

現在のSMTPシークレットの内容を表示します。

  • Linuxパッケージインストール:

    sudo gitlab-rake gitlab:smtp:secret:show
  • 自己コンパイルによるインストール:

    bundle exec rake gitlab:smtp:secret:show RAILS_ENV=production

Example output(出力例):

password: '123'
user_name: 'gitlab-inst'

シークレットをエディタで編集

シークレットの内容をエディタで開き、終了時に結果の内容を暗号化されたシークレットファイルに書き込みます。

  • Linuxパッケージインストール:

    sudo gitlab-rake gitlab:smtp:secret:edit EDITOR=vim
  • 自己コンパイルによるインストール:

    bundle exec rake gitlab:smtp:secret:edit RAILS_ENV=production EDITOR=vim

rawシークレットを書き込む

STDINで新しいシークレットコンテンツを書き込みます。

  • Linuxパッケージインストール:

    echo -e "password: '123'" | sudo gitlab-rake gitlab:smtp:secret:write
  • 自己コンパイルによるインストール:

    echo -e "password: '123'" | bundle exec rake gitlab:smtp:secret:write RAILS_ENV=production

シークレットの例

Editor example(エディタの例)

書き込みタスクは、編集コマンドがエディタで機能しない場合に使用できます:

# Write the existing secret to a plaintext file
sudo gitlab-rake gitlab:smtp:secret:show > smtp.yaml
# Edit the smtp file in your editor
...
# Re-encrypt the file
cat smtp.yaml | sudo gitlab-rake gitlab:smtp:secret:write
# Remove the plaintext file
rm smtp.yaml

KMS integration example(KMSインテグレーションの例)

KMSで暗号化されたコンテンツの受信アプリケーションとしても使用できます:

gcloud kms decrypt --key my-key --keyring my-test-kms --plaintext-file=- --ciphertext-file=my-file --location=us-west1 | sudo gitlab-rake gitlab:smtp:secret:write

Google Cloud secret integration example(Google Cloudシークレットインテグレーションの例)

Google Cloudからシークレットを受信するアプリケーションとしても使用できます:

gcloud secrets versions access latest --secret="my-test-secret" > $1 | sudo gitlab-rake gitlab:smtp:secret:write