跳至页脚内容
使用 IRONSECUREDOC

Docker Compose 环境变量(开发者教程)

在不同环境中部署应用程序常常导致兼容性问题。 一个应用程序可能在开发者的机器上运行良好,但由于操作系统、依赖项或配置的差异,在测试或生产阶段可能会遇到问题。 Docker通过将应用程序打包成包含所有运行所需内容的独立单元来解决这个问题,确保它在从开发到生产的各个阶段始终如一地运行。

Docker Compose为容器化应用程序带来了强大的优势,尤其是在使用环境变量简化不同设置的配置方面。 通过允许关键设置在代码外进行管理,Docker Compose使得部署复杂应用程序更加简单和安全。 在这些优势的基础上,本文还将展示如何使用IronSecureDoc进行安全文档处理,利用Docker Compose的灵活性有效处理加密和编辑配置。

什么是Docker?

Docker是一个开源系统,通过容器化技术简化应用程序的开发、部署和运行。 容器是超轻量级的便携单元,包含应用程序及其依赖项,以便它们在从开发者机器到生产服务器的各个环境中一致地运行。 与传统虚拟机相比,容器共享主机操作系统的内核,因此速度更快,效率更高。

Docker Compose 环境变量(开发者教程):图1 - Docker页面

这意味着一个以Docker镜像形式的虚拟模板,用于制作和维护这一组容器。 此外,该平台包含Docker Hub,它在某种程度上是一个容器镜像存储库。 这种技术的美妙之处在于其在可扩展性、可移植性和效率方面的易用性,这也是它在许多DevOps和基于云的开发工作流中获得如此流行的原因之一。

Docker-Compose中的环境变量是什么?

在Docker中,环境变量是一种键值对形式,用于配置容器化应用程序中的设置。 这样的变量可以在不修改代码的情况下控制应用程序本身的行为,因为诸如数据库凭证和API密钥或环境模式(例如:开发、生产)等配置可以轻松更改。

在Docker中,环境属性可以在Dockerfile中定义、在docker-compose.yml文件中定义,或在运行时使用docker run命令传递。 通过使用环境变量,Docker允许不同环境中一致和灵活的应用程序部署,并更有效地管理像密码和API令牌这样的敏感数据。

如何在Docker中创建环境变量?

我们可以通过多种方式在Docker中定义环境变量。 它们可以用Docker Compose文件、docker-compose.yml文件、环境文件,甚至在运行时执行docker run命令时定义。 记住,将环境变量与主配置文件分开会使变量的组织更简单! 这是可以用来定义变量的各种方法的列表。

在Dockerfile中设置环境变量

我们可以在Dockerfile中直接使用ENV指令定义环境变量。 如果您想要在Docker镜像中包含变量的默认值,这可能很有帮助。

# Dockerfile
# Set the application environment
ENV APP_ENV=development
# Set the database URL
ENV DATABASE_URL=postgres://user:password@db:1234/mydev

在Dockerfile中定义值的环境变量在容器运行时将自动应用。

在Docker-Compose.yml中设置环境变量

我们可以使用环境关键字在docker-compose.yml中为每个服务定义环境变量。 当您使用Docker Compose管理几个服务时,这非常方便。

version: '3.8'
services:
  myapp:
    image: myapp:latest
    environment:
      - APP_ENV=development
      - DATABASE_URL=postgres://user:password@db:1234/mydev
version: '3.8'
services:
  myapp:
    image: myapp:latest
    environment:
      - APP_ENV=development
      - DATABASE_URL=postgres://user:password@db:1234/mydev
YAML

在运行时设置环境变量

我们可以在运行容器时使用-e标志和docker run命令指定环境变量。 这适用于临时和动态值,您可能不会将其添加到Dockerfile中。

docker run -e APP_ENV=development -e DATABASE_URL=postgres://user:password@db:1234/mydev myapp:latest
docker run -e APP_ENV=development -e DATABASE_URL=postgres://user:password@db:1234/mydev myapp:latest
SHELL

使用环境文件 (.env)

我们可以将环境变量存储在类似.env的文件中,并将其加载到您的Docker容器中。 在Docker Compose中,我们将使用env_file指令引用它。

# .env file
APP_ENV=production
DATABASE_URL=postgres://user:password@db:1234/mydev
# .env file
APP_ENV=production
DATABASE_URL=postgres://user:password@db:1234/mydev
SHELL

我们可以通过环境文件帮助在配置文件之外管理多个文件的环境变量。

IronSecureDoc是什么?

IronSecureDoc for Docker使开发人员能够轻松地为他们的容器化应用程序添加安全文档处理功能。 学会使用Docker后,您可以在一个统一的环境中封装您的ASP.NET Core应用程序与IronSecureDoc一起,这使得部署和扩展变得更加容易。 为此,您将构建一个Dockerfile,该文件使用IronSecureDoc库和可能需要的其他安装脚本或配置来协调构建您的ASP.NET Core应用程序。

Docker Compose 环境变量(开发者教程):图2 - IronSecureDoc网页

此外,它包含一个docker-compose.yml文件声明服务依赖关系和环境变量以及映射端口。 这使得执行文档安全任务变得更加容易,因此您的应用程序可以在不同于开发或生产使用的环境中高效有效地运行。 Iron Secure Doc的安装和配置如Docker中一样,IronSecureDoc的正确安装和配置将是必要的,以便正确实现其功能:文档加密、编辑等。

IronSecureDoc的关键功能

IronSecureDoc提供了一系列强大的PDF安全和文档管理功能:

  • 加密:提供128或256位加密和基于密码的安全性,以保护文档机密性。
  • 编辑:删除敏感信息,例如个人识别符,以符合隐私标准和法规。
  • 数字签名:支持使用.pfx或.p12证书进行数字签名和公证,以确保文档真实性。
  • REST API:灵活的API可以与其他软件和工作流无缝集成。
  • Docker 集成:对Docker的原生支持简化了云端或本地应用程序的部署和扩展。

这些功能使IronSecureDoc成为处理敏感文档的行业的绝佳选择,如法律、医疗保健和金融领域。

安装和运行 IronSecureDoc

步骤 1

要安装IronSecureDoc,请在终端窗口或命令提示符中运行以下命令,以从存储库中获取IronSecureDoc Docker镜像。

docker pull ironsoftwareofficial/ironsecuredoc
docker pull ironsoftwareofficial/ironsecuredoc
SHELL

Docker Compose 环境变量(开发者教程):图3 - 获取 IronSecureDoc 镜像的控制台输出

步骤 2

一旦拉取了IronSecureDoc镜像,我们可以用以下docker-compose命令将其运行到Docker容器中。

docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> -e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latest
docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> -e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latest
SHELL

Docker Compose 环境变量(开发者教程):图4 - 运行 IronSecureDoc 镜像的控制台输出

我们使用docker容器运行IronSoftware的官方存储库。 上述命令行分为几个部分,以下将对其进行解释。

命令说明

  • docker container run - 该命令使用给定的镜像构建并启动一个新的Docker容器。
  • --rm - 一旦停止运行,自动清理容器。 在完成任何进程时,它会移除所有未使用的容器。
  • -p 8080:8080 - 发布容器的8080端口,这样您就可以从http://localhost:8080在您的机器上访问它。
  • -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> - 在运行的容器中设置一个名为 IronSecureDoc_LicenseKey 的环境变量,让您能够启用和使用 IronSecureDoc 的授权功能。 用您的实际密钥替换<IRONSECUREDOC_LICENSE_KEY>
  • -e ENVIRONMENT=Development - 环境变量被设置为开发状态。 这意味着容器需要在开发模式下运行。 通常,这个容器用于测试或调试案例; 除此之外,它与非生产配置有所不同。
  • -e HTTP_PORTS=8080 - 此环境变量用于指定容器应该开放并监听8080端口,以供HTTP流量使用。 它通过这一特定端口确保访问容器内的服务。
  • ironsoftwareofficial/ironsecuredoc:latest - 这是Docker镜像。 这表明应该从Docker注册表中使用IronSecureDoc的最新版镜像。

IronSecureDoc容器

IronSecureDoc的REST API允许用户在Docker中启动后可对文档进行修改、认证和加密。 启动IronSecureDoc Docker容器后,这里有一个指向API端点的链接和使用Swagger UI进行交互的文档:http://localhost:8080/swagger/index.html

Docker Compose 环境变量(开发者教程):图5 - 供您与API端点交互的Swagger UI

从上面的示例中,我们可以发送POST请求到IronSecureDoc API以提交文件进行加密:

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/encrypt?user_password=demo' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf'
curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/encrypt?user_password=demo' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf'
SHELL

这样做,IronSecureDoc会接收文档并正确加密。

结论

总之,Docker Compose的环境变量允许非常灵活和高效地配置应用程序,因为配置细节会自动与应用程序代码分离。 因此,管理不同环境(如开发、测试和生产)变得更简单,因为只需要更改API密钥、数据库凭证和应用程序设置等变量,而不是其代码。

使用Docker Compose实现IronSecureDoc利用了环境变量安全地处理授权信息,比如说IronSecureDoc_LicenseKey,同时也在指定HTTP端口或偏好的环境模式时(无论是开发还是生产)使用环境变量。 为设置使用环境变量使得部署IronSecureDoc变得更简单而不易产生混乱和难于扩展的配置,并提升了安全性。

通过有效的 许可证,IronSecureDoc 的高级功能变得可用。 工具的应用严格依赖于特定的使用条款。 您还可以利用Iron Software提供的其他高性能库,使开发过程更简单、更快捷,提供在任何可想的应用程序中处理PDF、文本识别和条形码的强大功能。

Docker Compose 环境变量(开发者教程):图6 - IronSecureDoc授权页面

常见问题解答

Docker Compose 如何改善应用程序部署?

Docker Compose 通过使用环境变量来管理外部配置,从而增强应用程序部署,允许在不同环境中轻松扩展和适应,而不修改应用程序代码。

环境变量在 Docker 中的作用是什么?

Docker 中的环境变量是独立于代码配置应用程序设置的键值对,允许安全管理诸如密码和 API 密钥等敏感信息。

IronSecureDoc如何与Docker集成以进行安全的文档处理?

IronSecureDoc 通过提供一个可以使用 Docker 命令获取和运行的 Docker 镜像来集成 Docker。它使用环境变量来配置安全文档处理功能,如加密、编辑和数字签名。

在 Docker Compose 中使用环境变量的好处是什么?

在 Docker Compose 中使用环境变量可以实现灵活的配置管理,通过将敏感数据保持在应用程序代码之外而提高安全性,并简化跨各种环境的部署流程。

如何在 Docker 环境中运行 IronSecureDoc?

要在 Docker 环境中运行 IronSecureDoc,可以使用命令 docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey= -e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latest,并指定必要的环境变量进行设置。

IronSecureDoc 提供哪些文档安全功能?

IronSecureDoc 提供文档加密、编辑、数字签名等功能,并与 Docker 无缝集成,以在容器化环境中安全处理文档。

如何在 Docker Compose 设置中设置环境变量?

可以使用 docker-compose.yml 文件、环境文件或运行时命令在 Docker Compose 中设置环境变量,从而在管理应用程序配置时提供灵活性和安全性。

为什么在 Docker 部署中将配置与代码分离很重要?

通过环境变量将配置与代码分离在 Docker 部署中很重要,因为它增强了安全性,简化了跨不同环境的管理,并减少了暴露敏感信息的风险。

Curtis Chau
技术作家

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位,专注于前端开发,精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面,喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

除了开发之外,Curtis 对物联网 (IoT) 有浓厚的兴趣,探索将硬件和软件集成的新方法。在空闲时间,他喜欢玩游戏和构建 Discord 机器人,将他对技术的热爱与创造力相结合。