# Инструкция: Удалённое выполнение команд по SSH из GitLab CI и Jenkins

## Подготовка

Перед запуском обоих пайплайнов необходимо:

1. Убедиться, что на **билдере** (удалённой машине) доступен `ssh` по ключу.
2. Сгенерировать ключ на runner/агенте (если его ещё нет):

```bash
ssh-keygen -t rsa -b 4096 -C "ci-key"
```

3. Копировать **публичный ключ** на билд-машину:

```bash
ssh-copy-id <user>@<ip_builder>
```

4. Убедиться, что `.ssh/id_rsa` и `.ssh/id_rsa.pub` доступны у пользователя runner/агента (например, `gitlab-runner` или `jenkins`).
5. Проверить подключение:

```bash
ssh -i ~/.ssh/id_rsa <user>@<ip_builder>
```

---

## GitLab CI: `.gitlab-ci.yml`

```yaml
stages:
  - remote-exec

ssh_execute:
  stage: remote-exec
  tags:
    - <runner_tag>
  script:
    - |
      SSH_HOST="<user>@<ip_builder>" 
      SSH_KEY="$HOME/.ssh/id_rsa"
      COMMANDS=$(cat <<EOF
        echo "Адрес билдера $SSH_HOST"
        echo "Запуск сборки проектов."
        /opt/global/gsf-cli/manage.sh --all build
EOF
      )
      echo "$COMMANDS" | ssh -i "$SSH_KEY" -o StrictHostKeyChecking=no "$SSH_HOST"
```

**Важно:**
- Runner должен быть с `executor: shell`.
- Убедитесь, что `id_rsa` доступен и читаем (`chmod 600`).
- Не забудьте указать свой `<runner_tag>`, `<user>`, `<ip_builder>`.

---

## Jenkins Groovy Pipeline

```groovy
pipeline {
    agent { label '<label_worker>' }

    environment {
        SSH_HOST = "<user>@<ip_builder>"
        SSH_KEY  = "$HOME/.ssh/id_rsa"
    }

    stages {
        stage('SSH Execute') {
            steps {
                script {
                    sh '''
                        ssh -i "$SSH_KEY" -o StrictHostKeyChecking=no "$SSH_HOST" << 'EOF'
echo "Адрес билдера $SSH_HOST"
echo "Запуск сборки проектов."
/opt/global/gsf-cli/manage.sh --all build
EOF
                    '''
                }
            }
        }
    }
}
```

**Важно:**
- Агент Jenkins должен быть с `shell` или `ssh` executor.
- Ключи должны быть в `$HOME/.ssh/` у пользователя, от имени которого работает Jenkins agent.
- Можно использовать Jenkins Credentials Plugin (SSH Key credentials) вместо `-i "$SSH_KEY"` — если нужно, напиши, сделаю вариант с credentialsId.

---

## Проверка

1. Закоммитьте `.gitlab-ci.yml` в репозиторий GitLab — пайплайн сработает автоматически.
2. Для Jenkins — создайте новый Pipeline Job и вставьте groovy-код в разделе **Pipeline Script**. Запустите вручную.