このページはClickHouse Cloudには該当しません。ここで説明している手順は、ClickHouse Cloud サービスでは自動化されています。
acme ブロックとあわせて設定します:
HTTP-01 チャレンジ (チャレンジタイプの詳細はこちら) のリクエストを処理します。検証が完了して証明書が発行されると、HTTPS ポートは取得した証明書を使って暗号化されたトラフィックを処理します。
HTTP ポートは、サーバー自体で 80 である必要はありません。nftables などのツールを使って別のポートに再マップできます。HTTP-01 チャレンジで使用できるポートについては、ACME プロバイダーのドキュメントを確認してください。
acme ブロックでは、アカウント作成用の email を設定し、ACME サービスの利用規約に同意します。
その後に必要なのは、ドメインのリストだけです。
- サポートされているチャレンジタイプは
HTTP-01のみです。 - サポートされている秘密鍵は
RSA 2048のみです。 - レート制限には対応していません。
acme セクションで使用できる設定オプション:
設定では、デフォルトで Let’s Encrypt の本番ディレクトリが使用されます。設定ミスによってリクエストのクォータに達するのを避けるため、まずは staging directory で証明書の発行プロセスをテストすることを推奨します。
複数のレプリカを持つクラスターで ACME クライアントを有効にする場合、証明書の初回発行時には特に注意が必要です。
ACME を有効にして起動した最初のレプリカは、ただちに ACME オーダーの作成を試み、HTTP-01 チャレンジの検証を行います。その時点でトラフィックを受けているレプリカが一部に限られていると、ほかのレプリカは検証リクエストに応答できないため、チャレンジは失敗する可能性が高くなります。
可能であれば、トラフィックを一時的に 1 つのレプリカのみにルーティングし (たとえば DNS レコードを調整して) 、そのレプリカで初回の証明書発行を完了させることをおすすめします。証明書が正常に発行されて Keeper に保存されたら、残りのレプリカでも ACME を有効にできます。これらのレプリカは既存の証明書を自動的に再利用し、以後の更新にも参加します。
トラフィックを 1 つのレプリカにルーティングできない場合は、代替手段として、ACME クライアントを有効にする前に既存の証明書と秘密鍵を Keeper に手動でアップロードできます。これにより初回の検証ステップを回避でき、すべてのレプリカを、有効な証明書がすでに存在する状態で起動できます。
初回の証明書が発行またはインポートされたあとは、すべてのレプリカですでに ACME クライアントが動作しており、Keeper を介して状態を共有するため、証明書の更新に特別な対応は必要ありません。
RSA 2048 の鍵のみです。
certbot から移行し、/etc/letsencrypt/live ディレクトリを使用している場合は、次の一連のコマンドを使用できます。