환경 API

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-Managed형, GitLab Dedicated

GitLab 16.2에서 GitLab CI/CD 작업 토큰 인증을 지원합니다.

환경 디렉터리

특정 프로젝트의 모든 환경을 가져옵니다.

GET /projects/:id/environments

속성	유형	필수	설명
`id`	정수/문자열	예	프로젝트의 ID 또는 URL 인코딩된 경로입니다.
`name`	문자열	아니요	해당 이름의 환경을 반환합니다. `search`와 상호 배타적입니다.
`search`	문자열	아니요	검색 기준과 일치하는 환경 디렉터리을 반환합니다. `name`과 상호 배타적이며, 적어도 3자 이상이어야 합니다.
`states`	문자열	아니요	특정 상태와 일치하는 모든 환경을 나열합니다. 허용되는 값: `available`, `stopping`, 또는 `stopped`. 상태 값이 지정되지 않으면 모든 환경을 반환합니다.

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/environments?name=review%2Ffix-foo"

응답 예시:

[
  {
    "id": 1,
    "name": "review/fix-foo",
    "slug": "review-fix-foo-dfjre3",
    "external_url": "https://review-fix-foo-dfjre3.gitlab.example.com",
    "state": "available",
    "tier": "development",
    "created_at": "2019-05-25T18:55:13.252Z",
    "updated_at": "2019-05-27T18:55:13.252Z",
    "enable_advanced_logs_querying": false,
    "logs_api_path": "/project/-/logs/k8s.json?environment_name=review%2Ffix-foo",
    "auto_stop_at": "2019-06-03T18:55:13.252Z"
  }
]

특정 환경 가져오기

GET /projects/:id/environments/:environment_id

속성	유형	필수	설명
`id`	정수/문자열	예	프로젝트의 ID 또는 URL 인코딩 된 경로입니다.
`environment_id`	정수	예	환경의 ID입니다.

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/environments/1"

응답 예시

{
  "id": 1,
  "name": "review/fix-foo",
  "slug": "review-fix-foo-dfjre3",
  "external_url": "https://review-fix-foo-dfjre3.gitlab.example.com",
  "state": "available",
  "tier": "development",
  "created_at": "2019-05-25T18:55:13.252Z",
  "updated_at": "2019-05-27T18:55:13.252Z",
  "enable_advanced_logs_querying": false,
  "logs_api_path": "/project/-/logs/k8s.json?environment_name=review%2Ffix-foo",
  "auto_stop_at": "2019-06-03T18:55:13.252Z",
  "last_deployment": {
      ...
  }
}

새로운 환경 만들기

주어진 이름과 external_url로 새로운 환경을 만듭니다.

환경이 성공적으로 만들어지면 201을 반환하고, 잘못된 매개변수의 경우 400을 반환합니다.

POST /projects/:id/environments

속성	유형	필수여부	설명
`id`	integer/string	yes	프로젝트의 ID 또는 URL-encoded path.
`name`	string	yes	환경의 이름.
`external_url`	string	no	이 환경에 대한 링크를 제공합니다.
`tier`	string	no	새로운 환경의 계층. 허용되는 값은 `production`, `staging`, `testing`, `development`, `other` 입니다.

curl --data "name=deploy&external_url=https://deploy.gitlab.example.com" \
     --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/environments"

예시 응답:

{
  "id": 1,
  "name": "deploy",
  "slug": "deploy",
  "external_url": "https://deploy.gitlab.example.com",
  "state": "available",
  "tier": "production",
  "created_at": "2019-05-25T18:55:13.252Z",
  "updated_at": "2019-05-27T18:55:13.252Z"
}

기존 환경 업데이트

매개변수 name은 GitLab 16.0에서 제거되었습니다.

기존 환경의 이름 및/또는 external_url을 업데이트합니다.

환경이 성공적으로 업데이트되면 200을 반환합니다. 오류 발생 시 상태 코드 400을 반환합니다.

PUT /projects/:id/environments/:environment_id

속성	유형	필수여부	설명
`id`	integer/string	yes	프로젝트의 ID 또는 URL-encoded path of the project.
`environment_id`	integer	yes	환경의 ID.
`external_url`	string	no	새로운 `external_url`.
`tier`	string	no	새로운 환경의 계층. 허용되는 값은 `production`, `staging`, `testing`, `development`, `other` 입니다.

curl --request PUT --data "external_url=https://staging.gitlab.example.com" \
     --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/environments/1"

예시 응답:

{
  "id": 1,
  "name": "staging",
  "slug": "staging",
  "external_url": "https://staging.gitlab.example.com",
  "state": "available",
  "tier": "staging",
  "created_at": "2019-05-25T18:55:13.252Z",
  "updated_at": "2019-05-27T18:55:13.252Z"
}

환경 삭제

환경이 성공적으로 삭제되면 204를 반환하고, 환경이 존재하지 않는 경우 404를 반환합니다. 환경은 먼저 중지되어야하며, 그렇지 않은 경우 요청은 403을 반환합니다.

DELETE /projects/:id/environments/:environment_id

속성	유형	필수여부	설명
`id`	integer/string	yes	프로젝트의 ID 또는 URL-encoded path.
`environment_id`	integer	yes	환경의 ID.

curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/environments/1"

중지된 여러 개의 리뷰 앱 삭제

이미 중지된 상태이며 리뷰 앱 폴더에 있는 여러 환경의 삭제를 예약합니다. 실제 삭제는 실행 시로부터 1주일 후에 수행됩니다. 기본적으로 30일 이전의 환경만 삭제합니다. before 매개변수를 사용하여 기본값을 변경할 수 있습니다.

DELETE /projects/:id/environments/review_apps

속성	유형	필수여부	설명
`id`	integer/string	yes	프로젝트의 ID 또는 URL-encoded path.
`before`	datetime	no	삭제할 환경의 이전 날짜. 기본값은 30일 전입니다. ISO 8601 형식 (`YYYY-MM-DDTHH:MM:SSZ`)으로 예상됩니다.
`limit`	integer	no	삭제할 환경의 최대 개수. 기본값은 100입니다.
`dry_run`	boolean	no	안전을 위해 기본값은`true`입니다. 실제 삭제가 수행되지 않는 드라이 런을 수행합니다. 환경을 실제로 삭제하려면`false`로 설정하십시오.

curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/environments/review_apps"

예시 응답:

{
  "scheduled_entries": [
    {
      "id": 387,
      "name": "review/023f1bce01229c686a73",
      "slug": "review-023f1bce01-3uxznk",
      "external_url": null
    },
    {
      "id": 388,
      "name": "review/85d4c26a388348d3c4c0",
      "slug": "review-85d4c26a38-5giw1c",
      "external_url": null
    }
  ],
  "unprocessable_entries": []
}

환경 중지

환경이 성공적으로 중지되면 200을 반환하고, 환경이 존재하지 않는 경우 404를 반환합니다.

POST /projects/:id/environments/:environment_id/stop

속성	유형	필수여부	설명
`id`	integer/string	yes	프로젝트의 ID 또는 URL-encoded path.
`environment_id`	integer	yes	환경의 ID.
`force`	boolean	no	`on_stop` 액션을 실행하지 않고 강제로 환경을 중지합니다.

curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/environments/1/stop"

예시 응답:

{
  "id": 1,
  "name": "deploy",
  "slug": "deploy",
  "external_url": "https://deploy.gitlab.example.com",
  "state": "stopped",
  "created_at": "2019-05-25T18:55:13.252Z",
  "updated_at": "2019-05-27T18:55:13.252Z"
}

황폐화된 환경 중지

지정된 날짜 이전에 마지막으로 수정되거나 배포된 모든 환경에 중지 요청을 발행합니다. 보호된 환경은 제외됩니다. 중지 요청이 성공하면 200을 반환하고, 이전 날짜가 잘못된 경우 400을 반환합니다. 환경이 정확히 언제 중지되는지에 대한 자세한 내용은 환경 중지를 참조하세요.

POST /projects/:id/environments/stop_stale

속성	유형	필수	설명
`id`	integer/string	yes	프로젝트의 ID 또는 URL-encoded path.
`before`	date	yes	지정된 날짜 이전에 수정되거나 배포된 환경을 중지합니다. ISO 8601 형식(`2019-03-15T08:00:00Z`)으로 예상됩니다. 유효한 입력값은 10년 전부터 1주일 전까지입니다.

curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/environments/stop_stale?before=10%2F10%2F2021"

예시 응답:

{
  "message": "모든 황폐한 환경에 대한 중지 요청이 성공적으로 완료되었습니다"
}

환경 API

환경 디렉터리

특정 환경 가져오기

새로운 환경 만들기

기존 환경 업데이트

환경 삭제

중지된 여러 개의 리뷰 앱 삭제

환경 중지

황폐화된 환경 중지

도움말

기능 사용 가능성과 제품 평가판

도움받기