@45air/air-local-docker 中文文档教程

Question

Air Local Docker

基于 Docker 的本地开发环境，适用于 Mac、Windows 和 Linux。 适合 WordPress 开发，但通常任何类型的网站都应该可以使用。 使用托管在 Docker Hub 上的公共 Docker 镜像和托管在 Quay 上的我们自己的公共 Docker 镜像来为您的站点设置开发环境。

可以通过运行 airlocal auth config 配置额外的附加组件和自动化，您可以在配置身份验证后使用 airlocal auth status 检查您的登录状态以确保它仍然有效。

Prerequisites

• Docker
• Docker Compose
• Node >= 10 or nvm
• npm >= 6.4.1

Installation

您可以通过私有 GitLab 包注册表安装已发布的版本。

步骤记录在下面链接的 GitLab 文档中。

https://docs.gitlab.com/ee/user/packages/npm_registry/index.html< /a>

直接链接到 Gitlab 上的包注册表。

https://devops.45air.co/tmbi/cli/air-local-docker/ -/packages

Setup

按照 TMBI 文档进行设置和安装。 使用橙色的 GitLab 登录按钮登录。

https://docs.tmbi.air-cloud.app/local-development

Command Documentation

Global Commands

Clearing Shared Cache

WP CLI，作曲家，和 npm 都利用缓存来加速操作并在未来节省带宽。

airlocal cache clear 清除 WP CLI、composer 和 npm 缓存。

Updating Docker Images

airlocal image update all 将确定 Air Local Docker 使用的哪些 docker 映像存在于您的系统上，并将它们更新到可用的最新版本。

Stopping global services

AirLocal 依靠一组全球服务来正常运行。 要关闭全局服务，请运行 airlocal stop all。 这将停止所有环境，然后停止全局服务。

Environments

Create an Environment

airlocal create 将向您显示一系列提示以配置您的环境以满足您的需要。

建议您为本地环境使用 .test 顶级域 (TLD)，因为此 TLD 保留用于软件测试，并不打算安装到全球域名中系统。 此外，AirLocal 配置为将 .test TLD 的任何容器到容器的流量直接发送到网关容器，这样 WP Cron 和 REST API 之类的东西就可以在开箱即用的环境之间工作。

Delete an Environment

airlocal delete 将删除具有给定主机名的环境。 与环境相关的任何本地文件、docker 卷和数据库都将被永久删除。

一个特殊的主机名 all 可用，它将删除所有环境。 系统将要求您确认删除每个环境。

Stop an Environment

airlocal stop 将停止环境运行，同时保留与该环境相关的所有文件、docker 卷和数据库。

一个特殊的主机名 all 可用，它将停止所有正在运行的环境以及全局服务。

Start an Environment

airlocal start 将启动一个预先存在的环境。

一个特殊的主机名 all 可用，它将启动所有环境以及全局服务。

Restart an Environment

airlocal restart 将重新启动与预先存在的环境关联的所有服务。

一个特殊的主机名 all 可用，它将重新启动所有环境以及全局服务。

Running WP CLI Commands

针对环境运行 WP CLI 命令很容易。 首先，确保您在环境目录中的某个位置（默认情况下，这是在 ~/air-local-docker-sites// 中的某个位置）。 一旦进入环境目录，只需运行 airlocal wp。 可以是您将直接传递给 WP CLI 的任何有效命令。

示例：

• airlocal wp search-replace mysite.com mysite.test
• airlocal wp site list

Shell

您可以使用 airlocal shell [] 命令在您环境中的任何容器中获取一个 shell。 如果未提供服务，则默认使用 phpfpm 容器。 其他可用服务可能会根据在创建环境期间选择的选项而有所不同，但可能包括：

• phpfpm
• nginx
• redis

Logs

使用 airlocal logs [] 命令可以获得实时容器日志。 如果未提供服务，则会显示当前环境中所有容器的日志。 要停止日志，请键入 ctrl+c。 可用服务可能因环境创建期间选择的选项而异，但可能包括：

• phpfpm
• nginx
• redis

Tools

phpMyAdmin

phpMyAdmin 作为全球服务堆栈的一部分提供部署以支持所有环境。

通过导航到 http://localhost:8092 访问 phpMyAdmin。

• Username: root
• Password: password

MailCatcher

MailCatcher 作为全球服务堆栈的一部分提供，该堆栈已部署以支持所有环境。 它预先配置为捕获从 Air Local Docker 创建的任何环境发送的邮件。

通过导航到 http://localhost:1080 访问 MailCatcher。

Xdebug

Xdebug 包含在 php 映像中，几乎可以开箱即用。 确保您的 IDE 正在侦听 PHP 调试连接，并设置路径映射到本地环境的 web/wp-content/ 目录到 /var/www/web/wp-content/< /代码> 在容器中。

Visual Studio Code

1. Install the PHP Debug extension.
2. In your project, go to the Debug view, click "Add Configuration…" and choose PHP environment. A new launch configuration will be created for you.
3. Set the pathMappings parameter to your local web/wp-content/ directory. Example:

"configurations": [
        {
            "name": "Listen for XDebug",
            "type": "php",
            "request": "launch",
            "port": 9000,
            "pathMappings": {
                "/var/www/web/wp-content": "${workspaceFolder}/web/wp-content",
            }
        }
]

Attribution

https://github.com/10up/wp-local-docker-v2