4.2. API エンドポイント
以下の API エンドポイントを利用できます。
/apis/build.openshift.io/v1/namespaces/{namespace}/builds/{name}/log
-
GET
: 指定された Build のログを読み取る
-
4.2.1. /apis/build.openshift.io/v1/namespaces/{namespace}/builds/{name}/log
パラメーター | 型 | 説明 |
---|---|---|
|
| BuildLog の名前 |
|
| チームやプロジェクトなどのオブジェクト名と認証スコープ |
パラメーター | 型 | 説明 |
---|---|---|
|
| ログをストリーミングするための cointainer。Pod にコンテナーが 1 つある場合、デフォルトではコンテナーのみになります。 |
|
| true の場合は、ビルドが終了するまでビルドログをストリーミングする必要があることを示します。 |
|
| insecureSkipTLSVerifyBackend は、apiserver が接続先のバックエンドの提供証明書の有効性を確認してはならないことを示します。これにより、apiserver とバックエンド間の HTTPS 接続が安全でなくなります。これは、apiserver が受け取っているログデータが実際の kubelet からのものであることを確認できないことを意味します。kubelet が apiserver の TLS 認証情報を検証するように設定されている場合は、実際の kubelet への接続が中間者攻撃に対して脆弱であることを意味するわけではありません (たとえば、攻撃者は実際の kubelet からの実際のログデータを傍受できませんでした)。 |
|
| limitBytes (設定されている場合) は、ログ出力を終了する前にサーバーから読み取るバイト数です。これにより、ロギングの完全な最終行が表示されない場合があり、指定された制限よりわずかに多いまたはわずかに少ない値が返される場合があります。 |
|
| noWait を true にすると、ビルドがまだ利用できない場合でも、呼び出しはすぐに戻ります。それ以外の場合、サーバーはビルドが開始するまで待機します。 |
|
| 'true' の場合、出力はきれいに印刷されます。 |
|
| previous は、以前のビルドログを返します。デフォルトは false です。 |
|
| sinceSeconds は、ログを表示する現在の時刻より前の相対時間 (秒単位) です。この値が Pod の開始時刻より前の場合は、Pod の開始以降のログのみが返されます。この値が将来の場合は、ログが返されません。sinceSeconds または sinceTime のいずれか 1 つのみを指定できます。 |
|
| tailLines (設定されている場合) は、表示するログの最後からの行数です。指定しない場合、ログはコンテナーの作成時、sinceSeconds、sinceTime から表示されます |
|
| タイムスタンプは、true の場合、ログ出力のすべての行の先頭に RFC3339 または RFC3339Nano タイムスタンプを追加します。デフォルトは false です。 |
|
| ログを表示するビルドのバージョン。 |
- HTTP メソッド
-
GET
- Description
- 指定された Build のログを読み取る
HTTP コード | 応答本文 |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |