老程序员博客

编程生涯的最后一舞

当前位置：首页 > 技术 > 正文内容

Earthly 最佳实践指南：构建高效可靠的容器化流程

访客 技术 2026年9月3日 3

Earthly 最佳实践指南：构建高效可靠的容器化流程

【免费下载链接】earthly Super simple build framework with fast, repeatable builds and an instantly familiar syntax – like Dockerfile and Makefile had a baby. 【免费下载链接】earthly 项目地址: https://gitcode.com/gh_mirrors/ea/earthly

概述

Earthly 是一款创新的构建自动化工具，它融合了 Dockerfile 的容器化能力与 Makefile 的灵活性。不论是单体应用、微服务架构，还是复杂的多仓库项目，Earthly 都能确保一致且可重复的构建体验。本文将深入探讨 Earthly 的最佳实践，助力您打造高效可靠的容器化工作流。

核心优势速览

特性 优势 适用场景
可重复构建 在任何环境表现一致 开发、测试、生产环境
简洁语法 结合 Dockerfile 和 Makefile 快速上手，降低学习门槛
多语言兼容 适配现有构建系统 多技术栈项目
多仓库支持 支持跨仓库引用与构建 微服务、monorepo
并行执行 自动并行化与缓存机制 大型项目加速
代码复用 目标引用和共享机制 减少重复代码编写

Earthfile 结构最佳实践

基础模板结构

VERSION 0.8
# 基础镜像定义
FROM alpine:3.18

# 依赖管理目标
deps:
    COPY package.json package-lock.json ./
    RUN npm ci
    SAVE ARTIFACT package.json AS LOCAL package.json
    SAVE ARTIFACT package-lock.json AS LOCAL package-lock.json

# 构建目标
build:
    FROM +deps
    COPY src/ ./
    RUN npm run build
    SAVE ARTIFACT dist/ /app AS LOCAL dist

# 测试目标
test:
    FROM +deps
    COPY src/ ./
    COPY test/ ./
    RUN npm test

# Docker 镜像构建
docker:
    COPY +build/dist/ ./
    ENTRYPOINT ["node", "index.js"]
    SAVE IMAGE --push my-app:latest

# 聚合目标
all:
    BUILD +build
    BUILD +test
    BUILD +docker

版本控制策略

mermaid

依赖管理最佳实践

分层缓存优化

VERSION 0.8
FROM node:18-alpine

# 第一层：仅依赖文件
deps-layer:
    COPY package.json package-lock.json ./
    RUN npm ci
    SAVE ARTIFACT package.json AS LOCAL package.json
    SAVE ARTIFACT package-lock.json AS LOCAL package-lock.json

# 第二层：源代码（依赖变更时才会重建）
build-layer:
    FROM +deps-layer
    COPY src/ ./
    RUN npm run build
    SAVE ARTIFACT dist/ /app AS LOCAL dist

# 第三层：测试（源代码变更时重建）
test-layer:
    FROM +deps-layer
    COPY src/ ./
    COPY test/ ./
    RUN npm test

多阶段构建模式

VERSION 0.8

# 开发环境构建
dev-build:
    FROM node:18-alpine
    COPY package.json package-lock.json ./
    RUN npm ci
    COPY src/ ./
    RUN npm run build:dev
    SAVE ARTIFACT dist/ AS LOCAL dist-dev

# 生产环境构建
prod-build:
    FROM node:18-alpine
    COPY package.json package-lock.json ./
    RUN npm ci --production
    COPY src/ ./
    RUN npm run build:prod
    SAVE ARTIFACT dist/ AS LOCAL dist-prod

# 最终镜像（使用最小基础镜像）
production-image:
    FROM alpine:3.18
    COPY +prod-build/dist/ /app/
    ENTRYPOINT ["/app/bin/start"]
    SAVE IMAGE my-app:prod

缓存策略深度优化

缓存粒度控制

VERSION 0.8
FROM python:3.11-slim

# 使用精确的缓存键
deps:
    COPY requirements.txt ./
    # 基于requirements.txt内容哈希的缓存
    RUN --cache-key=requirements pip install -r requirements.txt
    SAVE ARTIFACT requirements.txt AS LOCAL requirements.txt

build:
    FROM +deps
    COPY src/ ./
    # 源代码变更时重建
    RUN python -m compileall .
    SAVE ARTIFACT src/ AS LOCAL build-output

test:
    FROM +deps
    COPY src/ ./
    COPY tests/ ./
    # 测试文件变更时重新运行
    RUN python -m pytest tests/

共享缓存配置

VERSION 0.8
# 全局缓存配置
ARG CACHE_MODE=max
ARG CACHE_DIR=/cache

setup-cache:
    LOCALLY
    RUN mkdir -p $CACHE_DIR

build-with-cache:
    FROM +setup-cache
    RUN --cache-from=type=local,src=$CACHE_DIR \
        --cache-to=type=local,dest=$CACHE_DIR,mode=$CACHE_MODE \
        make build

多环境构建策略

环境变量管理

VERSION 0.8
# 环境配置
ARG ENV=development
ARG VERSION=1.0.0

config:
    LOCALLY
    RUN echo "Building for environment: $ENV"
    RUN echo "Version: $VERSION"

build:
    FROM +config
    COPY ./
    RUN --secret BUILD_ENV=$ENV \
        --secret APP_VERSION=$VERSION \
        ./build-script.sh

deploy:
    BUILD +build
    RUN --push --secret DEPLOY_KEY \
        ./deploy-script.sh $ENV

平台多架构支持

VERSION 0.8
# 多平台构建
all-platforms:
    BUILD \
        --platform=linux/amd64 \
        --platform=linux/arm64 \
        --platform=linux/arm/v7 \
        +docker

docker:
    FROM alpine:3.18
    CMD ["uname", "-m"]
    SAVE IMAGE multi-arch-image:$VERSION

测试集成最佳实践

分层测试策略

VERSION 0.8

unit-test:
    FROM +deps
    COPY src/ ./
    COPY test/unit/ ./
    RUN npm run test:unit

integration-test:
    FROM +deps
    COPY src/ ./
    COPY test/integration/ ./
    WITH DOCKER
        RUN npm run test:integration
    END

e2e-test:
    FROM +deps
    COPY src/ ./
    COPY test/e2e/ ./
    WITH DOCKER --compose docker-compose.test.yml
        RUN npm run test:e2e
    END

test-all:
    BUILD +unit-test
    BUILD +integration-test
    BUILD +e2e-test

测试覆盖率收集

VERSION 0.8

test-with-coverage:
    FROM +deps
    COPY src/ ./
    COPY test/ ./
    RUN npm run test:coverage
    SAVE ARTIFACT coverage/ AS LOCAL coverage-report

upload-coverage:
    BUILD +test-with-coverage
    RUN --push --secret CODECOV_TOKEN \
        bash -c "curl -s https://codecov.io/bash | bash -s - -t \$CODECOV_TOKEN"

安全最佳实践

安全扫描集成

VERSION 0.8

security-scan:
    FROM aquasec/trivy:latest
    COPY +build/dist/ /scan/
    RUN trivy filesystem --severity HIGH,CRITICAL /scan
    SAVE ARTIFACT trivy-report.json AS LOCAL security-reports/

docker-scan:
    FROM +docker
    RUN --no-cache trivy image my-app:latest

最小权限原则

VERSION 0.8

build-safe:
    FROM node:18-alpine
    # 使用非root用户
    RUN addgroup -g 1000 -S appgroup && \
        adduser -u 1000 -S appuser -G appgroup
    USER appuser
    COPY --chown=appuser:appgroup package*.json ./
    RUN npm ci
    COPY --chown=appuser:appgroup src/ ./
    RUN npm run build

监控和日志最佳实践

构建指标收集

VERSION 0.8

build-with-metrics:
    LOCALLY
    RUN echo "Build started at: $(date)" >> build-metrics.log
    
    BUILD +actual-build
    
    LOCALLY
    RUN echo "Build completed at: $(date)" >> build-metrics.log
    SAVE ARTIFACT build-metrics.log AS LOCAL metrics/

actual-build:
    FROM alpine:3.18
    RUN echo "Building application..."

故障排除和调试

调试模式支持

VERSION 0.8
ARG DEBUG=false

build:
    FROM alpine:3.18
    RUN if [ "$DEBUG" = "true" ]; then \
        echo "Debug mode enabled"; \
        set -x; \
    fi
    RUN ./build-script.sh

构建缓存诊断

VERSION 0.8

cache-stats:
    LOCALLY
    RUN earthly cache stats
    RUN earthly cache list

clear-cache:
    LOCALLY
    RUN earthly cache clear

invalidate-cache:
    LOCALLY
    RUN earthly cache invalidate +build

总结

Earthly 提供了一个强大而灵活的构建自动化平台，通过遵循这些最佳实践，您可以：

  1. 实现真正的环境一致性 - 在任何地方获得相同的构建结果
  2. 大幅提升构建性能 - 利用智能缓存和并行执行
  3. 简化复杂项目构建 - 支持多仓库、多平台架构
  4. 增强安全性 - 内置安全扫描和最小权限原则
  5. 改善可维护性 - 清晰的 Earthfile 结构和模块化设计

通过将这些最佳实践应用到您的项目中，您将能够构建出高效、可靠且易于维护的容器化流程，为团队的开发效率和产品质量提供坚实保障。

提示：始终使用最新版本的 Earthly 以获得最佳性能和最新功能特性。

【免费下载链接】earthly Super simple build framework with fast, repeatable builds and an instantly familiar syntax – like Dockerfile and Makefile had a baby. 【免费下载链接】earthly 项目地址: https://gitcode.com/gh_mirrors/ea/earthly

标签: Earthly容器化构建工具缓存优化
返回列表

上一篇：求解二叉树最近公共祖先的两种高效实现方案

没有最新的文章了...

相关文章

Linux crontab 详解

1) crontab 是什么cron 是 Linux 的定时任务守护进程；crontab 是用来编辑/查看“按时间周期执行命令”的表（cron table）。常见两类：用户 crontab：每个用户一份（crontab -e 编辑）系统级 crontab / cron.d：可指定执行用户（/etc/crontab、/etc/cron.d/*）2) crontab 时间...

富文本里可以允许的 HTML 属性

一、所有标签默认允许的安全属性（极少）class        （可选）id           （通常建议禁用）title️ 注意：id 容易被滥用做锚点注入，很多系统直接禁用class 允许的话最好只允许固定前缀（如 editor-*）二、a 标签允许属性<a href="" t...

Mac 安装 Node.js 指南

方法一：通过官网安装包（最简单，适合初学者）如果你只是想快速安装并开始使用，这是最直接的方法。访问 Node.js 官网。页面会显示两个版本：LTS (Recommended For Most Users)：长期支持版，最稳定。建议选这个。Current：最新特性版，包含最新功能但可能不够稳定。下载 .pkg 安装包并运行。按照安装向导点击“下一步”即可完成。方法二：使用 Homebrew 安装（...

Dom\HTML_NO_DEFAULT_NS 的副作用：自动加闭合标签

在使用Dom\HTMLDocument时，Dom\HTML_NO_DEFAULT_NS 将禁止在解析过程中设置元素的命名空间, 此设置是为了与DOMDocument向后兼容而存在的。当使用它时，已知的一个副作用就是：自动加闭合标签例如 </img> 为什么会这样？当你使用：Dom\HTML_NO_DEFAULT_NS文档会变成 无命名空间模式，此时内部更接近 XML...

Laravel 事件和监听器创建

在 Laravel 中，使用 Artisan 命令创建 Events（事件） 和 Listeners（监听器） 是非常高效的。你可以通过以下几种方式来实现：1. 手动创建单个 Event如果你只想创建一个事件类，可以使用 make:event 命令：Bashphp artisan make:event UserRegistered执行后，文件将生成在 app/Even...

自定义域名解析神器 dnsmasq

什么是 dnsmasq？dnsmasq 是一个轻量级、功能强大的网络服务工具，专为小型和中等规模网络设计。它是一个综合的网络基础设施解决方案[1]。dnsmasq 能做什么？功能说明应用场景DNS 转发与缓存将 DNS 查询转发到上游服务器（ISP、Google DNS 等），并在本地缓存结果加快 DNS 查询速度，减少外部 DNS 流量本地 DNS解析本地网络设备的主机名，无需编辑&n...

发表评论

访客

◎欢迎参与讨论，请在这里发表您的看法和观点。

Copyright © agingcoder.cn

Powered By Z-BlogPHP. Theme by TOYEAN.