Oracle Cloud 自动化部署 ARM 实例 (A1.Flex) 实践指南与避坑笔记

这是一份为您系统整理的 Oracle Cloud 自动化部署实践技术文档。

Oracle Cloud 自动化部署 ARM 实例 (A1.Flex) 实践指南与避坑笔记

文档版本： v1.0 场景描述： 在 Oracle Cloud 免费套餐额度内，利用闲置 AMD 实例作为跳板机，通过 OCI CLI 与资源管理器（Resource Manager），实现 24 小时无人值守自动化申请极度紧缺的美西圣何塞机房 ARM (A1.Flex) 实例。

1. 需求与根本原因排查复盘

初始需求： 申请一台 Always Free 的 VM.Standard.A1.Flex（4 OCPU, 24GB 内存, 100GB 引导卷）实例。
核心故障现象： 网页端创建时底部提示 API 错误: 可用性域 VM.Standard.A1.Flex 中配置 AD-1 的容量不足。
根本原因分析 (Root Cause Analysis)： 美西圣何塞机房（US West San Jose）因物理距离国内较近且网络直连质量高，其免费 ARM 物理宿主机资源池长期处于枯竭状态。常规的手动网页点击创建请求，在并发极高的机器脚本面前毫无胜算。
解决方案演进：
方案 A（抓包方案）： 提取网页 Cookie 写 Python 脚本。废弃原因：鉴权 Cookie 有效期极短（通常不足数小时），无法满足长期挂机需求。
方案 B（第三方开源庞大脚本）： 如 futchas 的纯手搓 CLI 脚本。废弃原因：需要手动从零抓取底层网络、镜像、子网等十几个 OCID 参数，极度繁琐且易错。
方案 C（最终最佳实践）： 网页端生成 Stack (堆栈) + 免密 API Key 鉴权 + 极简 OCI CLI 定时触发 + tmux 守护进程。将复杂的配置参数固化在云端，本地仅需发送触发执行指令。

2. 核心技术名词解释

Resource Manager (资源管理器) / Stack (堆栈): Oracle Cloud 提供的“基础设施即代码 (IaC)”服务，底层基于 Terraform。将网页上配置好的机器参数（CPU、内存、硬盘大小、网络）打包存放在云端，形成一个标准的执行模板（即“堆栈”）。
OCI CLI (Oracle Cloud Infrastructure Command Line Interface): Oracle 官方出品的命令行控制工具，是替代网页操作、实现云资源自动化的核心引擎。
OCID (Oracle Cloud Identifier): Oracle Cloud 中所有资源的唯一全局标识符。本方案主要涉及 User OCID（用户）、Tenancy OCID（租户）和 Stack OCID（堆栈）。
API Signing Key (API 签名密钥): 用于 OCI CLI 身份验证的 RSA 非对称密钥对。与 Cookie 不同，API 密钥不过期，是实现长期无人值守自动化的核心鉴权凭据。
tmux: Linux 下的终端复用器 (Terminal Multiplexer)。允许用户在一个窗口中创建多个会话，并且能在 SSH 断开连接后，让进程在系统后台继续安全运行。

3. 带注释的实操命令汇总

环境安装与鉴权配置

# 1. 下载并执行 OCI CLI 官方安装脚本
bash -c "$(curl -L https://raw.githubusercontent.com/oracle/oci-cli/master/scripts/install/install.sh)"

# 2. 刷新环境变量，使 oci 命令立刻生效
source ~/.bashrc
# 或者使用：exec -l $SHELL

# 3. 运行交互式配置向导 (需提前准备 User OCID 和 Tenancy OCID)
oci setup config

# 4. 查看并提取自动生成的公钥，用于填入 Oracle 网页端完成授权
cat ~/.oci/oci_api_key_public.pem

进程守护与挂机管理 (tmux)

# 创建并进入一个名为 auto_arm 的新后台会话
tmux new -s auto_arm

# 赋予脚本执行权限并启动脚本
chmod +x arm_stack.sh
./arm_stack.sh

# 退出但不终止当前后台会话的快捷键手势：
# 依次按下：Ctrl+B -> 松开 -> 按 D

# 重新进入已存在的后台会话（查岗或停止脚本用）
tmux attach -t auto_arm

# 在主系统外排查脚本是否仍在运行
ps -ef | grep arm_stack.sh

实例获取后的防火墙清理 (Ubuntu)

# 获取机器后，清理系统自带的强管控 iptables 规则，放行所有端口
sudo -i
iptables -P INPUT ACCEPT
iptables -P FORWARD ACCEPT
iptables -P OUTPUT ACCEPT
iptables -F
apt-get install -y iptables-persistent
netfilter-persistent save

4. 最终版配置文件代码

创建文件 arm_stack.sh，填入以下代码。

修改重点说明：

STACK_OCID: 必须替换为您自己在 Resource Manager 中生成的真实堆栈 OCID。
sleep 120: 延时参数。千万不可设置过低，120 秒（2分钟）是防止触发 Oracle WAF (Web 应用防火墙) 导致账号被风控的最佳实践阈值。

#!/bin/bash

# ================= 配置区 =================
# [重点修改项]: 将此处替换为您实际的堆栈 OCID (格式: ocid1.ormstack.oc1...)
STACK_OCID="ocid1.ormstack.oc1.us-sanjose-1.amaaaaaapzrp4tiajhsw7keeytrwgdoqn3j2oxfjv3q6evh3j2sfnf36b5nn"
# ==========================================

echo "开始自动执行堆栈抢机任务..."

while true; do
  current_time=$(date "+%Y-%m-%d %H:%M:%S")
  
  # 核心业务逻辑：调用 oci cli 向堆栈发送自动批准(AUTO_APPROVED)的运行作业(Job)
  result=$(oci resource-manager job create-apply-job \
    --stack-id "$STACK_OCID" \
    --execution-plan-strategy "AUTO_APPROVED" \
    2>&1)
    
  if [[ "$result" == *"Job"* ]]; then
      echo "[$current_time] 🚀 堆栈应用请求已成功发送并进入排队状态。"
  else
      # 注: 若网页端 Job 列表产生记录，此处的告警为文本不匹配导致的假报警，可忽略。
      echo "[$current_time] ⚠️ 请求发送失败或配额受限，继续重试..."
  fi
  
  # [重点安全项]: 强制休眠 120 秒，严格控制 API 请求速率避免账号封禁
  sleep 120
done

5. 避坑总结 (Lessons Learned)

OCI CLI 安装死循环陷阱： 若系统残留了旧的安装目录，脚本会询问 Remove this directory? (y/N)。默认选项是 N。若不仔细看直接狂按回车，会导致安装程序无限循环询问。必须手动输入小写 y 并回车才能破局。
API 密钥密码阻碍自动化： 在执行 oci setup config 生成密钥对时，系统会询问 Enter a passphrase for your private key。为了实现无人值守的挂机，绝对不能设置密码。必须直接按回车，或输入 N/A 确认跳过。否则脚本每次运行都会阻塞等待人工输入密码。
前/后台运行环境错位： 在使用 tmux 时，切忌将含有脚本运行命令（./arm_stack.sh）的多行代码一次性粘贴进终端。这会导致 tmux 退出后台后，脚本在主系统的前台裸跑。正确做法是：进入 tmux -> 手动输入运行命令 -> Ctrl+B, D 退出后台。
Oracle 告警邮件被国内邮箱拦截： 使用国内邮箱（如 139、QQ 等）订阅 Oracle 的 Events（事件）通知时，由于反垃圾策略，大概率会发生静默丢信。必须使用 Gmail 等海外主流邮箱 接收“Instance - Launch End”开机成功通知。
正确理解“Failed”状态： 自动化运行期间，网页端“作业 (Jobs)”列表中产生大量状态为 失败 (Failed) 的记录是完全正常的符合预期的现象。这证明请求已经成功穿透至 Oracle 后台，仅仅是因为物理服务器无货。不要因此怀疑脚本逻辑出错。

Revision #1
Created 2026-05-27 13:04:24 UTC by 天翰
Updated 2026-05-27 13:05:03 UTC by 天翰