6.2. ライフサイクル環境の操作
Satellite は、アプリケーションのライフサイクルを、ライフサイクル環境に分割します。ライフサイクル環境は、アプリケーションのライフサイクルの各ステージを表します。ライフサイクル環境は、環境パスからリンクされます。リンクされたライフサイクル環境を API で作成するには、prior_id パラメーターを使用します。
https://satellite.example.com/apidoc/v2/lifecycle_environments.html で、ライフサイクル環境に関する、同梱の API リファレンスを確認できます。API ルートには /katello/api/environments および /katello/api/organizations/:organization_id/environments が含まれます。
ライフサイクル環境の一覧表示
以下の API 呼び出しを使用して、Satellite にある ID が 1 のデフォルトの組織に対する現在の全ライフサイクル環境を表示します。
要求例:
curl --header "Accept:application/json" \ --header "Content-Type:application/json" \ --request GET --user My_User_Name:My_Password \ https://satellite.example.com/katello/api/organizations/1/environments \ | python3 -m json.tool`
$ curl --header "Accept:application/json" \
--header "Content-Type:application/json" \
--request GET --user My_User_Name:My_Password \
https://satellite.example.com/katello/api/organizations/1/environments \
| python3 -m json.tool`
応答例:
ライフサイクル環境のリンク作成
以下の例を使用して、ライフサイクル環境のパスを作成します。
以下の手順では、ID が 1 のデフォルトのライブラリー環境が、ライフサイクル環境作成の開始点として使用されています。
開始点として使用する既存のライフサイクル環境を選択します。その ID を使用して環境を表示します。今回の例では、ID が
1の環境を使用します。要求例:
curl --request GET --user My_User_Name:My_Password \ https://satellite.example.com/katello/api/environments/1 \ | python3 -m json.tool
$ curl --request GET --user My_User_Name:My_Password \ https://satellite.example.com/katello/api/environments/1 \ | python3 -m json.toolCopy to Clipboard Copied! Toggle word wrap Toggle overflow 応答例:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 以下のコンテンツを含めて、
life-cycle.jsonなどの JSON ファイルを作成します。{"organization_id":1,"label":"api-dev","name":"API Development","prior":1}{"organization_id":1,"label":"api-dev","name":"API Development","prior":1}Copy to Clipboard Copied! Toggle word wrap Toggle overflow priorオプションを1に設定してライフサイクル環境を作成します。要求例:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 応答例:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow コマンド出力では、このライフサイクル環境の ID が
2であり、その 1 つ前のライフサイクル環境が1であることがわかります。ID が2のライフサイクル環境を使用して、この環境の後継を作成します。以前作成した
life-cycle.jsonファイルを編集して、label、name、priorの値を更新します。{"organization_id":1,"label":"api-qa","name":"API QA","prior":2}{"organization_id":1,"label":"api-qa","name":"API QA","prior":2}Copy to Clipboard Copied! Toggle word wrap Toggle overflow priorオプションを2に設定して、ライフサイクル環境を作成します。要求例:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 応答例:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow コマンド出力では、ライフサイクル環境の ID が
3で、ライフサイクル環境は2であると分かります。
ライフサイクル環境の更新
PUT コマンドを使用してライフサイクル環境を更新できます。
以下の要求例では、ID が 3 のライフサイクル環境の説明を更新します。
要求例:
応答例:
ライフサイクル環境の削除
後継環境がない場合、ライフサイクル環境を削除できます。したがって、次の形式のコマンドを使用して逆の順序で削除します。
要求例:
curl --request DELETE --user My_User_Name:My_Password \ https://satellite.example.com/katello/api/environments/:id
$ curl --request DELETE --user My_User_Name:My_Password \
https://satellite.example.com/katello/api/environments/:id