# Образы

<div id="bkmrk-%D0%9E%D0%B1%D1%80%D0%B0%D0%B7---%D0%BA%D0%BE%D0%BD%D1%82%D0%B5%D0%B9%D0%BD%D0%B5%D1%80-%D1%82%D0%BE">Образ - контейнер только для чтения, содержащий все для запуска (минимальная ОС, приложение, зависимости, метаданные)</div><div id="bkmrk-%D0%9E%D0%B1%D1%80%D0%B0%D0%B7-%D1%81%D0%BE%D1%81%D1%82%D0%BE%D0%B8%D1%82-%D0%B8%D0%B7-%D1%81%D0%BB%D0%BE">Образ состоит из слоев, существующие слои общие для использования и могут быть в разных образах.</div><div id="bkmrk-%D0%9E%D0%B1%D1%80%D0%B0%D0%B7---manifest-%D1%84%D0%B0%D0%B9">Образ - manifest файл, в котором список слоев и метаданных.</div><div id="bkmrk-%D0%A1%D0%BB%D0%BE%D0%B9---%D1%86%D0%B5%D0%BB%D0%BE%D1%81%D1%82%D0%BD%D1%8B%D0%B9-%D0%BE%D0%B1%D1%8A">Слой - целостный объект. </div><div id="bkmrk-%D0%9A%D0%B0%D0%B6%D0%B4%D0%B0%D1%8F-%D0%BA%D0%BE%D0%BC%D0%B0%D0%BD%D0%B4%D0%B0-%D0%B2-doc">Каждая команда в dockerfile, модифицирующая файловую систему контейнера, создает новый слой.</div><div id="bkmrk-%D0%9D%D0%B5%D0%BB%D1%8C%D0%B7%D1%8F-%D1%83%D0%B4%D0%B0%D0%BB%D0%B8%D1%82%D1%8C-%D0%BE%D0%B1%D1%80%D0%B0%D0%B7">Нельзя удалить образ, пока последний контейнер не будет удален.</div><div id="bkmrk-%D0%9E%D0%B1%D1%80%D0%B0%D0%B7%D1%8B-%D0%BE%D0%B1%D1%8B%D1%87%D0%BD%D0%BE-%D1%85%D1%80%D0%B0%D0%BD%D1%8F%D1%82">Образы обычно хранятся в /var/lib/docker/&lt;storage-driver&gt;</div><div id="bkmrk-%21%D0%9D%D1%83%D0%B6%D0%BD%D0%BE-%D0%B4%D0%BE%D1%81%D1%82%D0%B0%D1%82%D0%BE%D1%87%D0%BD%D0%BE-%D0%BC%D0%B5"><span style="color: rgb(224, 62, 45);">!Нужно достаточно места в /var!</span></div><div id="bkmrk-%D0%A3-%D0%BE%D0%B1%D1%80%D0%B0%D0%B7%D0%B0-%D0%B5%D1%81%D1%82%D1%8C-hash-%28">У образа есть hash (digest), у каждого из слоев есть digest</div><div id="bkmrk-%D0%9F%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80-distributio">Параметр distribution hash - hash сжатого образа или образа для размещения в hub</div><div id="bkmrk-%D0%94%D0%BB%D1%8F-%D0%BF%D0%BE%D0%B4%D0%B4%D0%B5%D1%80%D0%B6%D0%BA%D0%B8-%D1%80%D0%B0%D0%B7%D0%BD%D1%8B%D1%85">Для поддержки разных архитектур и платформ для одного названия (напр. golang:latest) используются manifest list и manifests</div><div id="bkmrk-%D0%94%D0%BB%D1%8F-%D0%BA%D0%B0%D0%B6%D0%B4%D0%BE%D0%B3%D0%BE-%D0%BA%D0%BE%D0%BD%D1%82%D0%B5%D0%B9%D0%BD%D0%B5">Для каждого контейнера создается новый слой чтения/записи</div><div class="align-center" id="bkmrk-%D0%9A%D0%BE%D0%BC%D0%B0%D0%BD%D0%B4%D1%8B-%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D1%8B-%D1%81-%D0%BE%D0%B1%D1%80">**Команды работы с образами**  
</div><div id="bkmrk-%D0%91%D0%B0%D0%B7%D0%BE%D0%B2%D0%B0%D1%8F-%D0%BA%D0%BE%D0%BC%D0%B0%D0%BD%D0%B4%D0%B0-%D0%94%D0%BE%D0%BF."><table border="1" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 17.9983%;"></col><col style="width: 17.1626%;"></col><col style="width: 64.8391%;"></col></colgroup><thead><tr><td class="align-center">Базовая команда</td><td class="align-center">Доп. парам.</td><td class="align-center">Описание</td></tr></thead><tbody><tr><td>**docker images**</td><td>  
</td><td>Список установленных образов</td></tr><tr><td>  
</td><td>-q</td><td>только отображение ID контейнеров</td></tr><tr><td>  
</td><td>--digests</td><td>добавляет столбец с хэшем образа</td></tr><tr><td>  
</td><td>dangling: true/false</td><td>Образы без тега. Происходит если при создании нового образа сохраняется тег старого. У старого обнуляется тэг, у нового остается.</td></tr><tr><td>  
</td><td>label: &lt;label&gt;</td><td>Фильтрует на основе наличия метки или ярлыка и значения. Команда docker images не отображает метки в своих выходных данных.</td></tr><tr><td>**docker search**</td><td>&lt;слово&gt;</td><td>поиск в dockerhub по слову &lt;слово&gt;</td></tr><tr><td>  
</td><td>--filter ""</td><td>Доп. фильтр ```bash
docker search alpine --filter "is-official=true"
```

</td></tr><tr><td>  
</td><td>--limit число</td><td>кол-во выдачи, максимум 100</td></tr><tr><td>**docker image pull**

Синоним:

**docker pull**

</td><td>&lt;repository&gt;:&lt;tag&gt;</td><td>Загрузка образа из репозитория

repository:

- В случае официального образа на docker hub: одно слово
- В случае неофициального образа на docker hub: слово/слово ```bash
    docker pull nigelpoulton/tu-demo:v2
    ```
- В случае внешнего хранилища: адрес хранилища без http(s) ```bash
    docker pull gcr.io/google-containers/git-sync:v3.1.5
    ```

</td></tr><tr><td>  
</td><td>&lt;digest&gt;</td><td>Хэш образа</td></tr><tr><td>**docker image push**

Синоним:

**docker push**

</td><td>&lt;repository&gt;:&lt;tag&gt;|&lt;digest&gt;</td><td>Загрузка образа на репозиторий, доп. параметры аналогичны pull</td></tr><tr><td>**docker image prune**</td><td>&lt;repository&gt;:&lt;tag&gt;</td><td>удаление образа из локального хранилища</td></tr><tr><td>  
</td><td>-a</td><td>удаление всех неиспользуемых контейнерами образов</td></tr><tr><td>**docker image build**

**docker build**

</td><td>-t тег образа. обычно имя:версия

&lt;путь к dockerfile&gt; - обязательный

</td><td>Создание образа из dockerfile ```
docker build -t myapp:1.0 .
docker build -t ${PROJECT_NAME}_db:${VERSION} ./database
```

</td></tr><tr><td>**docker image tag**

**docker tag**

</td><td>  
</td><td>Создать тэг TARGET\_IMAGE связанный с SOURCE\_IMAGE Это нужно только для публикации образа в dockerhub ```
docker tag ddd-book:ch8.1 nigelpoulton/ddd-book:ch8.1
```

</td></tr><tr><td>**docker rmi**</td><td>  
</td><td>Удаляет заданный образ или несколько образов.

Удаление всех образов:

```bash
docker rmi $(docker images -q) -f
```

Эта команда удаляет старые теги без удаления образа, если есть еще образы, ссылающиеся на этот образ.

</td></tr><tr><td>**docker inspect &lt;имя или ID образа&gt;**</td><td>  
</td><td>информация по образу

</td></tr><tr><td>**docker info | grep Storage**</td><td>  
</td><td>При использовании docker pull или docker-compose up -d образы размещаются в /var/lib/docker/overlay2

</td></tr></tbody></table>

</div><div id="bkmrk-"></div>