一、HowToCook介绍

1.1 HowToCook简介

HowToCook 是一个为程序员量身定制的开源烹饪指南项目，旨在用结构化和自动化的方式帮助程序员轻松掌握在家做饭的技能。

1.2 主要特点

1. 结构化菜谱：每个菜谱像程序一样清晰划分输入、处理和输出，方便理解和复用。
2. 时间管理优化：提供步骤时间估算，帮助程序员合理安排做饭与工作的时间。
3. 食材最小集推荐：基于常见食材设计菜谱，减少采购复杂度和频率。
4. 一键生成购物清单：自动整理多道菜所需的食材并去重，方便批量采购。
5. 错误处理机制：为烹饪中的失败情况提供“调试建议”，提升容错能力。
6. 命令行工具支持：提供开发者熟悉的CLI操作方式，便于快速查找和使用菜谱。
7. 社区协作开发：所有内容开源，支持用户提交改进，持续迭代更新。
8. 离线本地部署：无需网络即可使用，适合部署在本地或静态网站平台。

二、本次实践规划

2.1 本地环境规划

本次实践为个人测试环境，操作系统版本为|Ubuntu 22.04.1。

2.2 本次实践介绍

1.本次实践部署环境为个人测试环境，生产环境请谨慎；
2.在Docker环境下部署HowToCook做菜工具。

三、本地环境检查

3.1 检查Docker服务状态

检查Docker服务是否正常运行，确保Docker正常运行。

root@jeven01:~# systemctl status docker
● docker.service - Docker Application Container Engine
     Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled)
     Active: active (running) since Wed 2025-05-07 03:58:22 UTC; 7h ago
TriggeredBy: ● docker.socket
       Docs: https://docs.docker.com
   Main PID: 841 (dockerd)
      Tasks: 11
     Memory: 93.0M
        CPU: 3.341s
     CGroup: /system.slice/docker.service
             └─841 /usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock

3.2 检查Docker版本

检查Docker版本

root@jeven01:~#  docker -v
Docker version 28.1.1, build 4eba377

3.3 检查docker compose 版本

检查Docker compose版本，确保2.0以上版本。

root@jeven01:~# docker compose version
Docker Compose version v2.35.1

四、下载HowToCook镜像

如果拉取原镜像ghcr.io/anduin2017/how-to-cook:latest缓慢或失败，可使用registry.cn-hangzhou.aliyuncs.com/jeson/how-to-cook:latest容器镜像。

root@jeven01:~# docker pull registry.cn-hangzhou.aliyuncs.com/jeson/how-to-cook:latest
latest: Pulling from jeson/how-to-cook
f2551cfab4d2: Pull complete
d164380718aa: Pull complete
93243487a3a0: Pull complete
addaac47f0e7: Pull complete
0cf267162caa: Pull complete
0cf41fd94f42: Pull complete
79986b67de44: Pull complete
25fbfbf72a28: Pull complete
faba959d864d: Pull complete
d8fb4825853c: Pull complete
7f9b31437d29: Pull complete
Digest: sha256:6ac5ce8dfbbcaeb37543959189bf7e97e00931b2a7694b103c0416596a2d2d4c
Status: Downloaded newer image for registry.cn-hangzhou.aliyuncs.com/jeson/how-to-cook:latest
registry.cn-hangzhou.aliyuncs.com/jeson/how-to-cook:latest

五、部署HowToCook应用

5.1 创建部署目录

• 创建部署目录

mkdir -p /data/howtocook  &&  cd /data/howtocook

5.2 编辑部署文件

• 如果使用docker-cli部署，可使用以下命令。（可选）

docker run -d --name mycook --restart always -p 5000:5000 registry.cn-hangzhou.aliyuncs.com/jeson/how-to-cook:latest

在`部署目录下，创建docker-compose.yaml文件，如下所示：

vim docker-compose.yaml

version: '3.9'
services:
    jeson:
        image: 'registry.cn-hangzhou.aliyuncs.com/jeson/how-to-cook:latest'
        ports:
            - '5000:5000'
        restart: always
        container_name: mycook

5.3 创建HowToCook容器

执行以下命令，创建HowToCook容器。

root@jeven01:/data/howtocook# docker compose up -d
WARN[0000] /data/howtocook/docker-compose.yaml: the attribute `version` is obsolete, it will be ignored, please remove it to avoid potential confusion
[+] Running 2/2
 ✔ Network howtocook_default  Created                                                                                                             0.0s
 ✔ Container mycook           Started                                                                                                             0.3s

5.4 查看HowToCook容器状态

检查HowToCook容器状态状态，确保HowToCook容器正常启动。

root@jeven01:/data/howtocook# docker compose ps
WARN[0000] /data/howtocook/docker-compose.yaml: the attribute `version` is obsolete, it will be ignored, please remove it to avoid potential confusion
NAME      IMAGE                                                        COMMAND                  SERVICE   CREATED              STATUS              PORTS
mycook    registry.cn-hangzhou.aliyuncs.com/jeson/how-to-cook:latest   "/bin/sh -c '/app/st…"   jeson     About a minute ago   Up About a minute   0.0.0.0:5000->5000/tcp, [::]:5000->5000/tcp

5.5 查看HowToCook容器日志

检查HowToCook容器日志，确保HowToCook服务正常运行。

docker compose logs

六、访问HowToCook服务

6.1 访问初始页

浏览器地址： http://<个人的服务器IP>:5000，访问HowToCook服务的初始页。如果无法访问，请确保宿主机的防火墙已关闭或已放行相关端口，对于云服务器还需配置相应的安全组规则。

6.2 开始做菜

可以搜索菜名，也可以直接在菜谱列表寻找，例如做一道宫保鸡丁，可以看到详细的做菜流程。

七、总结

通过本次实践，我们成功使用 Docker 部署了 HowToCook 菜谱工具，体验了其简洁清晰的界面和结构化菜谱带来的便利。整个部署过程流程清晰，体现了容器化技术在快速搭建应用上的优势。未来可根据个人需求进一步扩展功能或集成到本地开发环境中，实现更智能的烹饪管理。