Документация по репозиторию

Если у вас уже есть приложение, которое вы хотите развернуть в Amvera, 
но он уже использует другой репозиторий git (GitHub, Bitbucket или что-то другое), 
можно привязать дополнительный remote к вашему репозиторию.

Инструкции по подключению указаны на странице проекта.

Откройте командную строку и перейдите в корневую папку 
проекта вашего приложения. Выполните указанные команды:

```
git remote add amvera 
https://git.amvera.ru/<имя-пользователя>/<транслитерированное-имя-проекта>
git push amvera master
```

На запрос пользователя и пароля укажите имя пользователя 
и пароль вашей учетной записи Amvera.

Чтобы началась сборка, у вас должен быть файл `amvera.yml` 
или `amvera.yaml` и/или `Dockerfile` в одном из следующих мест 
относительно корня вашего репозитория:

1. amvera/Dockerfile
2. Dockerfile
3. docker/Dockerfile
4. deploy/Dockerfile
5. deployment/Dockerfile

Если [amvera.yml](https://docs.amvera.ru/books/amvera/page/fail-konfiguracii) 
и/или Dockerfile не найден ни в одном из указанных мест, сборка не удастся.

За процессом сборки можно наблюдать на странице проекта 
на вкладке логов сборки:

В случае успешного развертывания вы увидите статус "Успешно развернуто":

В случае, если во время сборки произошла ошибка, вы увидите статус 
"Сборка завершилась с ошибкой":


Причину ошибки обычно можно найти в логах сборки:

Запущенные инстансы вашего проекта при ошибке сборки не 
останавливаются и продолжат работать.

#### Возможные ошибки

Если у вас основная ветка называется не `master`, а, например, `main`, 
при выполнении команды `git push amvera master` вы столкнетесь с ошибкой.

В таком случае выполните команду:

```
git push amvera имя_основной_ветки:master
```

Так, например, если ваша основная ветка называется `main`, 
команда будет выглядеть следующим образом:

```
git push amvera main:master
```

Если вы не знаете как называется основная ветка в вашем репозитории, 
узнать это можно, выполнив следующую команду 
(если вы не знаете как называется ваша основная ветка, 
вы скорее всего на ней находитесь):

```
git branch --show-current
```

Если вы начинаете разработку своего приложения и хотите использовать 
Amvera для хостинга, вы можете использовать репозиторий git как основной.

Инструкции по подключению указаны на странице проекта.


Вы можете склонировать пустой репозиторий:

```
git clone https://git.amvera.ru/<имя-пользователя>/<транслитерированное-имя-проекта>
```

Или можно подключить репозиторий к локальному репозиторию:

```
git remote add origin https://git.amvera.ru/<имя-пользователя>/<транслитерированное-имя-проекта>
```

Напишите код ваашего приложения. 
Чтобы его можно было собрать, напишите файл [amvera.yml 
(https://docs.amvera.ru/books/amvera/page/fail-konfiguracii) и/или Dockerfile. 
Файл `amvera.yml` можно альтернативно называться `amvera.yaml` 
и обязан находиться в корне репозитория. 
Если вы написали `Dockerfile`, расположите его в одном 
из следующих мест относительно корня репозитория:

1. amvera/Dockerfile
2. Dockerfile
3. docker/Dockerfile
4. deploy/Dockerfile
5. deployment/Dockerfile

Если `amvera.yml` и/или `Dockerfile` не найден ни в одном 
из указанных мест, сборка не удастся.

Когда вы готовы запустить ваш проект, отправьте изменения в репозиторий:

```
git push -u origin master
```

За процессом сборки можно наблюдать на странице проекта на вкладке логов сборки:

В случае успешного развертывания вы увидите статус "Успешно развернуто":


В случае, если во время сборки произошла ошибка, вы увидите статус 
"Сборка завершилась с ошибкой":


Причину ошибки обычно можно найти в логах сборки:


Запущенные инстансы вашего проекта при ошибке сборки 
не останавливаются и продолжат работать.