Начало работы с контейнером WSL

Это пошаговое руководство поможет вам приступить к созданию и запуску контейнеров Linux на Windows с помощью wslc.exeинтерфейса командной строки контейнера, который поставляется с WSL.

wslc.exe предоставляет знакомый интерфейс командной строки для создания, доставки и запуска контейнерных приложений.

Обзор контейнеров WSL

Контейнер — это средство, используемое для создания, развертывания и запуска приложений. Контейнеры позволяют разработчикам упаковывать приложение со всеми нужными частями (библиотеки, платформы, зависимости и т. д.) и отправлять все это как один пакет. Использование контейнера гарантирует, что приложение будет работать одинаково независимо от настраиваемых параметров или ранее установленных библиотек на компьютере, на котором он работает, который может отличаться от компьютера, который использовался для записи и тестирования кода приложения. Это позволяет разработчикам сосредоточиться на написании кода, не беспокоясь о системе, в которую будет выполняться код.

Предпосылки

• WSL установлен. Запустите wsl --update , чтобы убедиться, что у вас установлена последняя версия.
• Установите Visual Studio Code(необязательно). Это обеспечит лучший интерфейс, включая возможность кода и отладки контейнерных проектов, подключенных к дистрибутиву Linux.
• Установите терминал Windows(необязательно). Это обеспечит лучший интерфейс, включая возможность настройки и открытия нескольких терминалов в одном интерфейсе (включая Ubuntu, Debian, PowerShell, Azure CLI или любой вариант использования).

Установка и проверка wslc

wslc.exe входит в состав WSL, поэтому отдельный модуль устанавливать не нужно. Чтобы убедиться, что у вас есть версия WSL, которая включает в себя:

1. Установите WSL , если у вас еще нет, а затем обновите до последней версии, открыв PowerShell и введя следующее:

   wsl --update
   

2. Убедитесь, что wslc.exe доступен, и проверьте его версию, введя:

   wslc version
   

3. Проверьте, что всё работает правильно, запустив простой встроенный образ. Образ автоматически извлекается, если он еще не присутствует локально:

   wslc run --rm hello-world
   

   Должно появиться сообщение "Hello", подтверждающее правильность работы установки.

Запуск первых контейнеров

С помощью wslc.exe можно загружать образы, запускать контейнеры в активном режиме или в фоновом режиме, публиковать порты и взаимодействовать с запущенными контейнерами. Попробуйте выполнить несколько следующих команд из PowerShell:

# Run a command in a throwaway container
wslc run --rm -it ubuntu:latest bash -c "echo Hello world from WSL container!"

# Run a web server in the background and publish port 8080 to the container's port 80
wslc run -d --rm -p 8080:80 --name web nginx

# Request content from the running web server
curl localhost:8080

# List the running container
wslc container list

# Run an additional command inside the running container
wslc exec web cat /etc/os-release

# Stop the container
wslc container stop web

Так как контейнер nginx был запущен с помощью --rm, он автоматически удаляется после остановки.

Создайте и запустите собственный образ контейнера

Чтобы начать разработку приложений с помощью wslc.exe, мы рекомендуем использовать VS Code вместе с расширением WSL, чтобы редактировать свой проект в файловой системе Linux и выполнять команды wslc из интегрированного терминала.

Давайте создадим образ контейнера для существующего проекта приложения.

1. В этом примере мы будем использовать исходный код из руководства Hello World для Django, приведённого в документации по настройке среды разработки Python. Этот шаг можно пропустить, если вы предпочитаете использовать исходный код собственного проекта. Чтобы скачать веб-приложение HelloWorld-Django из GitHub, откройте терминал WSL (например, Ubuntu) и введите следующее:

   git clone https://github.com/<username>/helloworld-django.git
   

   Замечание

   Всегда храните код в той же файловой системе, в которую вы используете средства. Это приведет к повышению производительности доступа к файлам. В этом примере мы используем дистрибутив Linux (Ubuntu) и хотим хранить файлы проекта в файловой системе \\wsl$WSL. Хранение файлов проекта в файловой системе Windows значительно замедлит работу при использовании средств Linux в WSL для доступа к этим файлам.

2. В терминале WSL измените каталоги на папку исходного кода для этого проекта:

   cd helloworld-django
   

3. Откройте проект в VS Code, запущенном на локальном сервере расширений WSL, введя следующее:

   code .
   

   Убедитесь, что вы подключены к дистрибутиву WSL Linux, проверив зеленый удаленный индикатор в левом нижнем углу экземпляра VS Code.

   

4. Добавьте Containerfile в корневой каталог проекта, который описывает, как собрать образ. В примере Django минимальное Containerfile может выглядеть следующим образом:

   FROM python:3
   WORKDIR /app
   COPY requirements.txt .
   RUN pip install --no-cache-dir -r requirements.txt
   COPY . .
   EXPOSE 8000
   CMD ["python", "manage.py", "runserver", "0.0.0.0:8000"]
   

5. Из папки проекта (каталога, содержащего ваш Containerfile) соберите образ с помощью wslc build, присвоив ему имя-тег, на которое позже можно будет ссылаться:

   wslc build -t helloworld-django .
   

6. Убедитесь, что изображение создано, просмотрев список своих изображений:

   wslc image list
   

7. Запустите созданный образ как контейнер, опубликуйте порт приложения, чтобы получить доступ к нему из Windows:

   wslc run -d --rm -p 8000:8000 --name django helloworld-django
   

8. Чтобы убедиться, что контейнер запущен, просмотрите список запущенных контейнеров и проверьте журналы контейнера:

   wslc container list
   wslc container logs django
   

9. Откройте браузер в Windows и перейдите по адресу http://localhost:8000/, чтобы увидеть, как ваше приложение работает в контейнере. Вы также можете убедиться, что приложение работает в Linux, выполнив команду внутри контейнера:

   wslc exec django uname
   

   Результат uname "Linux" подтверждает, что контейнер работает в ядре WSL 2 Linux.

10. По завершении остановите контейнер:

    wslc container stop django
    

Теперь вы успешно создали и запустили контейнер Linux в Windows с помощью wslc.exe, работающего на базе WSL 2, и теперь можете собирать, запускать, развертывать и отлаживать его в VS Code!

Устранение неполадок

Проверка контейнера или образа

Когда контейнер непредвиденно работает, inspectlogs команды предоставляют подробные сведения для диагностики проблемы:

wslc container inspect <container-id>
wslc container logs <container-id>
wslc image inspect <image>

Восстановление места на диске

Образы и остановленные контейнеры занимают место на диске. Чтобы очистить ресурсы, которые вы больше не используете:

# Remove all stopped containers
wslc container prune

# Remove unused images
wslc image prune

Дополнительные сведения об устранении неполадок в WSL см. в документации по устранению неполадок .

Дополнительные ресурсы

• Обзор контейнера WSL
• Примеры API контейнеров WSL
• Microsoft Learn: Введение в контейнеры
• Документация ПО VS Code: разработка в WSL