application-env

Application Env 操作速查

reconcile Step 6I / 更新分支 C 用。Env 维度可独立增删改查，不需要重 PATCH 整个 application。

公共环境变量（同 application-crud.md）：

BASE="http://120.77.223.183:8000"
APP_UUID="<application-uuid>"

列出现有 envs（reconcile Step 6 check）

curl -sS \
  -H "Authorization: Bearer $COOLIFY_API_TOKEN" \
  "$BASE/api/v1/applications/$APP_UUID/envs" \
  | jq '[.[] | {uuid, key, value, is_literal}]'

返回数组，每条含 uuid（env 的）+ key + value + 几个 flag。

注意：value 在响应里是明文（除非 is_shown_once: true）——agent 看到也不要 echo / 不要写日志。

对比仓库 .env 与 Coolify 现状（reconcile Step 6 check）

必须 grep 过滤 Coolify 魔法变量前缀 (详见本文末尾"关于 Coolify 魔法变量"段), 否则每次都误诊 "Coolify 多了一堆 key"：

MAGIC_PREFIXES='^(SERVICE_PASSWORD_|SERVICE_PASSWORDWITHSYMBOLS_|SERVICE_REALBASE64_|SERVICE_HEX_|SERVICE_FQDN_)'

REMOTE_KEYS=$(curl -sS -H "Authorization: Bearer $COOLIFY_API_TOKEN" \
  "$BASE/api/v1/applications/$APP_UUID/envs" \
  | jq -r '.[].key' \
  | grep -vE "$MAGIC_PREFIXES" \
  | sort)

LOCAL_KEYS=$(grep -v '^\s*#' .env | grep '=' | cut -d= -f1 \
  | grep -vE "$MAGIC_PREFIXES" \
  | sort)

echo "缺的 (本地有，Coolify 没):"
comm -23 <(echo "$LOCAL_KEYS") <(echo "$REMOTE_KEYS")
echo "多的 (Coolify 有，本地没):"
comm -13 <(echo "$LOCAL_KEYS") <(echo "$REMOTE_KEYS")

值的对比单独做（值不打印到屏幕，用文件 diff 或 hash 对比）：

# 不打印明文，只显示哪些 key 的值不同
for key in $(comm -12 <(echo "$LOCAL_KEYS") <(echo "$REMOTE_KEYS")); do
  local_val_hash=$(grep "^${key}=" .env | cut -d= -f2- | sha256sum | cut -c1-8)
  remote_val_hash=$(curl -sS -H "Authorization: Bearer $COOLIFY_API_TOKEN" \
    "$BASE/api/v1/applications/$APP_UUID/envs" \
    | jq -r --arg k "$key" '.[] | select(.key==$k) | .value' \
    | sha256sum | cut -c1-8)
  [ "$local_val_hash" != "$remote_val_hash" ] && echo "$key: 不同 (本地 ${local_val_hash} vs Coolify ${remote_val_hash})"
done

创建一个 env（reconcile Step 6 act：补缺）

curl -sS -X POST \
  -w "\nHTTP=%{http_code}\n" \
  -H "Authorization: Bearer $COOLIFY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d "$(jq -nc --arg k "MY_KEY" --arg v "my_value" \
    '{key: $k, value: $v, is_literal: true}')" \
  "$BASE/api/v1/applications/$APP_UUID/envs"