# Как настроить Job или Pipeline на знакомом вам CI-инструменте?

Рассмотрим пример настройки **Pipeline и Job** на популярном CI-инструменте **GitLab CI/CD**, так как он часто используется в корпоративной разработке.

***

#### **1. Создаём файл `.gitlab-ci.yml`**

Файл находится в корне репозитория и описывает pipeline и job.

```yaml
# Определяем стадии (stages)
stages:
  - build
  - test
  - deploy

# Job для сборки
build_job:
  stage: build
  image: python:3.11
  script:
    - pip install -r requirements.txt
    - python setup.py build
  artifacts:
    paths:
      - dist/

# Job для тестирования
test_job:
  stage: test
  image: python:3.11
  script:
    - pip install -r requirements.txt
    - pytest tests/

# Job для деплоя (пример на staging)
deploy_job:
  stage: deploy
  script:
    - echo "Deploying to staging server..."
  when: manual   # запуск вручную
```

***

#### **2. Как это работает**

1. **Pipeline** запускается при каждом коммите в ветку (по умолчанию `push`).
2. Pipeline состоит из **трёх стадий** (`stages`): `build`, `test`, `deploy`.
3. В каждой стадии выполняется **Job**:
   * `build_job` — собирает проект, создаёт артефакты.
   * `test_job` — запускает автоматические тесты.
   * `deploy_job` — выполняет деплой (можно ручной через `when: manual`).
4. Jobs внутри одной стадии могут выполняться **параллельно**, стадии выполняются **последовательно**.

***

#### **3. Дополнительные возможности**

* **Кэширование зависимостей** для ускорения сборки:

```yaml
cache:
  paths:
    - .venv/
```

* **Использование разных образов Docker** для job через `image`.
* **Ограничение запуска job на конкретной ветке**:

```yaml
only:
  - main
```

***

Итог:

* **Pipeline** — это последовательность стадий для автоматизации CI/CD.
* **Job** — отдельная задача, выполняемая на агенте CI/CD.
* Настройка производится в файле `.gitlab-ci.yml`, где указываются стадии, скрипты, зависимости, артефакты и условия запуска.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://kaze.gitbook.io/qa-theory/ci/kak-nastroit-job-ili-pipeline-na-znakomom-vam-ci-instrumente.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.