ruthless/servicenow-instance-wakeup

servicenow-instance-wakeup 镜像文档

镜像概述和主要用途

该Docker镜像封装了一个用于唤醒ServiceNow实例的工具，旨在减少手动唤醒休眠实例所需的时间。它通过模拟用户手动登录开发者门户、填写凭据、等待重定向并点击唤醒按钮的流程，自动化完成实例唤醒的必要步骤。请注意：此工具并非用于保持实例持续唤醒，仅在实例处于休眠状态时执行唤醒操作，实例唤醒后不会执行任何操作，也不会生成保持实例唤醒的行为。

免责声明

本工具的设计目的是减少手动唤醒实例的时间，而非保持实例唤醒。当前手动唤醒实例通常需要3-4分钟（有时更长），其中90%的时间用于等待重定向、填写用户名密码、等待更多重定向及点击唤醒按钮。本工具仅模拟这些手动步骤，仅在实例处于休眠状态且存在唤醒按钮时点击该按钮，不会执行任何保持实例唤醒的操作。若实例已唤醒，工具将不会工作或执行任何操作。

请勿将本工具归类为危害免费PDI计划的软件。曾有将其改造为保持实例唤醒工具的尝试（如https://github.com/0x111/servicenow-instance-wakeup/issues/10%EF%BC%89%EF%BC%8C%E4%BD%86%E5%B7%B2%E8%A2%AB%E6%8B%92%E7%BB%9D%E3%80%82%E8%AF%B7%E5%B0%8A%E9%87%8D%E8%BF%99%E4%B8%80%E8%AE%BE%E8%AE%A1%E5%8E%9F%E5%88%99%E3%80%82

核心功能和特性

• 自动登录：使用提供的凭据自动登录ServiceNow开发者门户
• 流程模拟：模拟手动唤醒实例的完整流程，包括处理重定向
• 条件触发：仅在实例处于休眠状态时执行唤醒操作，实例已唤醒时无任何动作
• 时间优化：大幅减少手动唤醒步骤所需时间，专注于自动化等待和交互过程
• 无额外行为：不生成任何保持实例唤醒的操作，仅复现用户原本需要手动完成的步骤

使用场景和适用范围

适用于ServiceNow开发者实例用户，当实例因超时而进入休眠状态后，需要唤醒实例继续开发或测试时使用。尤其适合希望减少重复手动操作时间、提高工作效率的开发者，帮助其将原本3-4分钟的手动唤醒流程简化为自动化执行。

Docker使用方法

镜像获取

从Docker Hub拉取

bash
docker pull ruthless/servicenow-instance-wakeup

从Github Packages拉取

bash
docker pull ghcr.io/0x111/servicenow-instance-wakeup:latest

注：未来可能逐步迁移至Github Packages，Docker Hub的维护将视平台政策变化调整。

从源码构建

1. 克隆GitHub仓库并进入目录：

   bash
   git clone https://github.com/0x111/servicenow-instance-wakeup.git
   cd servicenow-instance-wakeup
   

2. 执行构建命令：

   bash
   docker build --rm -f "Dockerfile" -t servicenowinstancewakeup:latest "."
   

运行示例

基本运行

使用环境变量传入必要的用户名和密码：

bash
docker run -e USERNAME='your_username@example.com' -e PASSWORD='your_password' servicenow-instance-wakeup

自定义配置

可通过环境变量配置调试模式（DEBUG）和无头模式（HEADLESS）：

bash
docker run -e USERNAME='your_username@example.com' -e PASSWORD='your_password' -e DEBUG='true' -e HEADLESS='false' servicenowinstancewakeup

环境变量说明

容器支持通过环境变量配置工具的所有命令行参数，默认值如下：

注意事项

• 确保提供的用户名和密码正确，否则登录失败将导致唤醒流程无法执行
• 实例已唤醒时，工具不会执行任何操作，无需担心重复运行
• 请尊重ServiceNow的使用政策，不要将此工具用于非授权场景
• 若遇到问题或有功能建议，可通过项目GitHub仓库提交issue或PR，欢迎贡献

该工具仅用于自动化用户原本需要手动执行的实例唤醒步骤，旨在提高效率，而非规避实例休眠机制。请合理使用并遵守相关规定。