PF pavelfilippov.ru

Справошная ★ Поиск

Установка DDEV

TYPO3

Docker Desktop/CE или Colima Предварительное условие

Прежде чем что-либо будет работать с DDEV, требуется Docker или его альтернатива. Это довольно просто в большинстве сред; см . страницу docker_installation , чтобы разобраться в деталях, особенно в Windows и Linux. Установка docker-compose не требуется, поскольку DDEV использует собственную приватную версию.

macOS (Доморощенный)

Для пользователей macOS (как amd64, так и arm64) мы рекомендуем установку и обновление через Homebrew : brew install drud/ddev/ddev.

В качестве одноразовой инициализации запустите mkcert -install.

Позже, чтобы перейти на более новую версию DDEV-Local, запустите brew upgrade ddev.

Чтобы установить предварительные выпуски DDEV, подпишитесь на канал «edge» с помощью brew install drud/ddev-edge/ddevи установите последнюю невыпущенную версию DDEV, brew unlink ddev && brew install drud/ddev/ddev --HEAD.

Linux (системы на базе Arch, такие как EndeavourOS или Manjaro)

Мы поддерживаем пакет на Arch Linux (AUR) .

ПРИМЕЧАНИЕ. Установка пакета в системах на основе Arch предпочтительнее, чем сценарий установки, описанный ниже.

В качестве одноразовой инициализации запустите mkcert -install, для чего может потребоваться ваш пароль sudo. Дополнительную информацию см. ниже.

Linux, macOS и Windows WSL2 (сценарий установки)

ПРИМЕЧАНИЕ. Пользователям macOS, установившим через Homebrew, или пользователям Arch Linux, установившим через описанный выше менеджер пакетов, сценарий установки не требуется.

Пользователи Linux, macOS и Windows WSL2 (см. ниже) могут использовать эту строку кода на своем терминале для загрузки, проверки и установки (или обновления) ddev с помощью сценария install_ddev.sh . Обратите внимание, что это работает как с архитектурами amd64, так и с arm64, включая Surface Pro X с WSL2 и 64-разрядной ОС Raspberry Pi. Он также работает с компьютерами MacOS Apple Silicon M1.

 

curl -LO raw.githubusercontent.com/drud/ddev/master/scripts/install_ddev.sh && bash install_ddev.sh

 

Сценарий установки также может принимать аргумент версии, чтобы установить конкретную версию или предварительную версию. Например,

 

curl -LO raw.githubusercontent.com/drud/ddev/master/scripts/install_ddev.sh && bash install_ddev.sh v1.19.0-alpha5

 

Чтобы обновить DDEV до последней стабильной версии, просто снова запустите скрипт.

Windows (WSL2)

Это рекомендуемый метод установки для всех пользователей Windows .

Все выпуски Windows 10/11 (включая Windows 10 Home) поддерживают WSL2 . Если вы уже знакомы с DDEV в Windows, возможно, вы использовали NFS для повышения производительности файловой системы. После перехода на WSL2 вам больше не понадобится NFS , так как она сразу обеспечивает потрясающую производительность файловой системы.

Процесс установки WSL2 включает в себя:

  • Установка менеджера пакетов Chocolatey (необязательно).
  • Однократная инициализация mkcert.
  • Установка WSL2 и установка дистрибутива, такого как Ubuntu.
  • Установка или обновление до последней версии Docker Desktop для Windows с включенным WSL2.
  • Установка DDEV внутри вашего дистрибутива.

Мы рассмотрим их более подробно. Вы можете предпочесть другие методы установки или некоторые шаги могут не потребоваться, но это полный рецепт:

  1. Если вы уже устанавливали Docker Toolbox, полностью удалите Docker Toolbox .
  2. Chocolatey: мы рекомендуем использовать Chocolatey для установки необходимых приложений Windows, таких как mkcert. В административной оболочке PowerShellSet-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))
  3. В административной оболочке PowerShell:choco install -y mkcert
  4. В административной оболочке PowerShell запустите mkcert -installи ответьте на запрос, разрешающий установку центра сертификации.
  5. В административной оболочке PowerShell выполните команду setx CAROOT "$(mkcert -CAROOT)"; If ($Env:WSLENV -notlike "*CAROOT/up:*") { setx WSLENV "CAROOT/up:$Env:WSLENV" }. Это настроит WSL2 на использование центра сертификации, установленного на стороне Windows.
  6. В административной оболочке PowerShell выполните команду wsl --install. Это установит для вас WSL2 и Ubuntu. Перезагрузитесь, когда это будет сделано.
  7. Docker Desktop для Windows: если у вас уже есть последняя версия Docker Desktop, настройте ее в общих настройках, чтобы использовать механизм на основе WSL2. В противном случае установите последнюю версию Docker Desktop для Windows и при установке выберите механизм на основе WSL2 (не устаревший Hyper-V). Установите через Chocolatey с помощью choco install docker-desktopили его можно загрузить с desktop.docker.com . Запустите Докер. Вам может быть предложено выйти и снова войти в систему или перезагрузиться.
  8. Перейдите в настройки Docker Desktop > Ресурсы > Интеграция с WSL > включите интеграцию для вашего дистрибутива (теперь dockerкоманды будут доступны из вашего дистрибутива WSL2).
  9. Дважды проверьте в PowerShell: wsl -l -vдолжны отображаться три дистрибутива, и ваш Ubuntu должен быть по умолчанию. Все три должны быть WSL версии 2.
  10. Перепроверьте в Ubuntu (или вашем дистрибутиве): echo $CAROOTдолжно появиться что-то вроде/mnt/c/Users/<you>/AppData/Local/mkcert
  11. Убедитесь, что докер работает внутри Ubuntu (или вашего дистрибутива):docker ps
  12. Необязательно: если вы предпочитаете использовать традиционный Windows ddev вместо работы внутри WSL2, установите его с расширением choco install -y ddev. Windows ddev отлично работает с механизмом Docker на основе WSL2. Однако установка WSL2 ddev гораздо предпочтительнее и как минимум в 10 раз быстрее. Поддержка традиционного подхода Windows в конечном итоге будет прекращена.
  13. Откройте терминал WSL2, например, Ubuntuиз меню «Пуск» Windows.
  14. Установите Homebrew: /bin/bash -c "$(curl -fsSL raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"(см . brew.sh .)
  15. Добавьте brew к вашему пути, как было предложено:,echo 'eval $(/home/linuxbrew/.linuxbrew/bin/brew shellenv)' >> ~/.profile && source ~/.profile
  16. brew install gcc && brew install drud/ddev/ddev
  17. sudo apt-get update && sudo apt-get install -y xdg-utilsустановить пакет xdg-utils, позволяющий ddev launchработать.

Вот и все! Теперь вы установили DDEV на WSL2. Если вы используете WSL2 для DDEV (рекомендуется), не забудьте запустить все ddevкоманды внутри дистрибутива WSL2.
Следуйте инструкциям Linux, macOS and Windows WSL2 (install script)выше.
Убедитесь, что вы поместили свои проекты в файловую систему Linux (например, /home/ ), а не в файловой системе Windows (/mnt/c), потому что вы получите гораздо более высокую производительность в файловой системе Linux.

Обратите внимание, что поддержка мутагена или nfs-mount (и работающая NFS) не требуются для WSL2, потому что она очень быстра даже без этих опций.

Windows (традиционная/устаревшая)

DDEV отлично работает на стороне Windows, хотя по умолчанию он немного медленнее, чем WSL2, но пользователи, которые включили мутаген, сообщили о хороших результатах ddev config global --mutagen-enabled.

  • Если вы используете шоколадку (рекомендуется), то можно просто choco install ddev gitиз административной оболочки. Апгрейды только ddev poweroff && choco upgrade ddev.
  • Установщик Windows предоставляется в каждом выпуске ddev ( ddev_windows_installer.<version>.exe). Запустите его, и он выполнит полную установку за вас. Откройте новое окно git-bash, PowerShell или cmd и начните использовать ddev.
  • Большинство людей взаимодействуют с ddev в Windows с помощью git-bash, входящего в состав набора Windows git . Хотя ddev работает с cmd и PowerShell, он больше подходит для bash. Вы можете установить его с помощью шоколадного choco install -y git.
  • Для повышения производительности многие пользователи включают мутаген ddev config global --mutagen-enabled(глобальный) или ddev config --mutagen-enabledтолько для одного проекта.

Linux и macOS (вручную)

Вы также можете легко выполнить установку или обновление вручную, если это необходимо. DDEV — это всего лишь один исполняемый файл, никакой специальной установки на самом деле не требуется, поэтому для всех операционных систем установка просто копирует DDEV на то место, где он находится в системном пути.

  • ddev poweroffпри обновлении
  • Загрузите и распакуйте последнюю версию ddev для вашей архитектуры.
  • Переместите ddev в /usr/local/bin: mv ddev /usr/local/bin/(может потребоваться sudo) или в другой каталог по вашему $PATHусмотрению.
  • Запустите ddev, чтобы проверить вашу установку. Вы должны увидеть вывод использования команды DDEV.
  • В качестве одноразовой инициализации запустите mkcert -install, для чего может потребоваться ваш пароль sudo. Пользователям Linux, возможно, придется предпринять дополнительные действия, описанные ниже в дополнительных инструкциях для Linuxmkcert -install . Если у вас не установлен mkcert, вы можете установить его с https://github.com/FiloSottile/mkcert/releases . Загрузите версию для правильной архитектуры и sudo mv <downloaded_file> /usr/local/bin/mkcert && sudo chmod +x /usr/local/bin/mkcert.

mkcert -installДополнительные инструкции для Linux

Шаг mkcert -installдля Linux может предоставить вам дополнительные инструкции.

В вариантах Linux вам может быть предложено установить дополнительный пакет для установки certutil, но вы можете следовать инструкциям mkcert:

$ mkcert -install
Создал новый локальный ЦС в "/home/username/.local/share/mkcert"
Установка в системный магазин пока не поддерживается в этом Linux, но Firefox и/или Chrome/Chromium по-прежнему будут работать.
Вы также можете вручную установить корневой сертификат в «/home/username/.local/share/mkcert/rootCA.pem».
Предупреждение: «certutil» недоступен, поэтому CA не может быть автоматически установлен в Firefox и/или Chrome/Chromium! ⚠️
Установите «certutil» с помощью «apt install libnss3-tools» или «yum install nss-tools» и повторно запустите «mkcert -install»

(Обратите внимание на приглашение Installing to the system store is not yet supported on this Linux, которое может быть простым результатом отсутствия /usr/sbin в пути, чтобы /usr/sbin/update-ca-certificatesего можно было найти.)

Дополнительные инструкции для Windows/Firefox

Шаг mkcert -installв Windows не работает для браузера Firefox.
Вам необходимо самостоятельно добавить созданный корневой центр сертификации в
конфигурацию безопасности:

  • Выполнить mkcert -install(для этого можно использовать ярлык из меню «Пуск»)
  • Запустите mkcert -CAROOT, чтобы увидеть локальную папку, используемую для вновь созданного корневого
    центра сертификации .
  • Откройте настройки Firefox (о: настройки#конфиденциальность)
  • Введите certificatesв поисковую строку вверху
  • НажмитеView Certificates...
  • Выберите вкладкуAuthorities
  • Нажмите дляImport...
  • Перейдите в папку, в которой был сохранен ваш корневой центр сертификации.
  • Выберите файлrootCA.pem
  • Нажмите дляOpen

Теперь вы должны увидеть свой ЦС в разделе mkcert development CA.