meteor/agent-skills

meteor-deployment

Use when deploying a Meteor 3 application.

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/meteor/agent-skills --skill meteor-deployment

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

Meteor deployment

meteor build produces a self-contained Node bundle that runs anywhere the matching Node.js version runs. Galaxy is the first-party host; Docker / Kubernetes / SSH-to-a-Node-host all work too.

For Android/iOS artifacts and native HCP compatibility, use meteor-native. Check actual native configuration as well as compatibility hashes: permission or other native configuration changes can require a new binary with an unchanged hash.

Match the Node version to the bundled Meteor Node:

MeteorNode major
3.020
3.1 through 3.422
3.5+24

Mismatch causes runtime errors. Run meteor node -v to confirm.

Decision flow

  1. Galaxy? Choose Git Push to Deploy or the Meteor CLI. Configure Galaxy's

settings source, build hooks, health checks, and domains from references/galaxy.md.

  1. Docker / Kubernetes? meteor build --directory ./build --server-only

skips platform-specific mobile artifacts. Use --architecture os.linux.x86_64 for a cross-build.

  1. SSH to a Node host? Same meteor build, scp the bundle, install prod

deps under bundle/programs/server, run node main.js.

  1. Vercel / Netlify / serverless? Not supported. Meteor needs a

long-lived Node process with a WebSocket.

Required environment

VarPurpose
ROOT_URLAbsolute external URL (e.g. https://app.example.com).
MONGO_URLmongodb://... connection string.
MONGO_OPLOG_URLOptional Mongo replica oplog URL.
PORTListen port. Default 3000.
BIND_IPNetwork interface. Default 0.0.0.0.
METEOR_SETTINGSJSON; populates Meteor.settings.
MAIL_URLSMTP for Email.send and account emails.

ROOT_URL is the external URL the browser sees, not the cluster-internal service URL. OAuth redirects, Meteor.absoluteUrl, and CSP all rely on it.

On Meteor 3.0 through 3.4, configure MONGO_OPLOG_URL for oplog-backed reactivity; without it, Meteor polls. Meteor 3.5+ can use core change streams without that variable and falls back to oplog or polling when needed. Atlas hosting alone does not add core change-stream support to an older Meteor app.

settings.json

json
{
  "public": { "appName": "My App", "stripePublishableKey": "pk_live_..." },
  "stripeSecretKey": "sk_live_...",
  "oauthSecretKey": "16-byte-base64==",
  "mailgun": { "apiKey": "..." }
}

Top-level keys: server only. public subtree: shipped to the client.

Load:

bash
# dev
meteor run --settings settings.json

# production
METEOR_SETTINGS=$(cat settings.json) node bundle/main.js

Galaxy

Choose one deployment path:

PathUse whenTrigger
Push to DeployGalaxy should build a connected GitHub or Bitbucket branch.Every push to the selected branch.
Meteor CLIA person or CI pipeline controls each upload.meteor deploy <app-name>.

For a Free app, pass a simple app name, not a custom domain:

bash
meteor login
meteor deploy myapp --free --settings settings.json

DEPLOY_HOSTNAME=eu-west-1.galaxy-deploy.meteor.com \
  meteor deploy myapp --plan essentials --settings settings.json

Galaxy assigns a myapp.sandbox.galaxycloud.app hostname on Free or a regional myapp.<region>.galaxycloud.app hostname on paid plans. Add custom domains in the dashboard. The active primary domain controls ROOT_URL.

Galaxy injects PORT, ROOT_URL, and METEOR_SETTINGS. Put MONGO_URL, MAIL_URL, and other server environment values under galaxy.meteor.com.env in the Galaxy settings JSON. Do not assume a CLI --settings file overrides Repository Mode.

See references/galaxy.md for settings modes, Push to Deploy builds, zero-downtime rollout and rollback, proxies, Mongo TLS, memory, and custom base images.

Docker

See references/docker.md for a working multi-stage Dockerfile. Build the bundle in one stage, install server deps and run in a smaller one. --server-only skips platform-specific mobile application builds, but it does not omit the browser client or create an API-only bundle. Meteor still builds the web.cordova client target used for hot code push.

Hot code push

autoupdate provides production hot code push. It detects a new client version over DDP, applies stylesheet-only changes without reloading when possible, and otherwise performs a full browser reload. Remove autoupdate from .meteor/packages to disable HCP.

hot-module-replacement is different. It replaces accepted JavaScript modules during development and falls back to HCP when a module cannot accept the update. HMR is disabled in production and on unsupported web architectures. There is no Meteor.disableClientResourceFetch switch in the current public API.

Anti-patterns

  • Commit settings.json with production secrets. Use a CI secret store

or env vars; load with METEOR_SETTINGS=$(cat ...) at startup.

  • Set ROOT_URL to the internal Kubernetes service URL. Use the

external HTTPS URL or OAuth redirects and Meteor.absoluteUrl break.

  • Run a Node version that does not match the bundled Meteor Node. Always

check meteor node -v.

  • Build on the wrong architecture. M-series Mac developers building for

x8664 Linux must pass `--architecture os.linux.x8664`.

  • Commit Galaxy settings with credentials or expect Repository Mode to read a

CLI --settings file. Keep secrets in Galaxy Mode or a secret store.

  • Hardcode Galaxy's port, load-balancer IP, or regional DNS target. Read

$PORT and copy current network values from the app dashboard.

  • Bundle the source tree into the Docker image alongside the built

bundle. Use multi-stage; the runtime image holds only bundle/.

See also

  • references/settings-and-env.md
  • references/galaxy.md
  • references/docker.md
  • references/eval-cases.md

관련 작업

같은 저장소의 Skills

더 많은 Skills

모든 Skills
meteor
커뮤니티

meteor-cli-installation

Use when installing, locating, repairing, resetting, or uninstalling the Meteor CLI for Meteor 3 development. Triggers on "meteor: command not found", npx meteor, installer failures, PATH problems, specific Meteor versions, clean reinstall requests, meteor reset, or corrupted dev bundles. Use this skill when the user asks about fresh workstation setup or making a local Meteor command available. For application failures after the CLI starts, use meteor-debugging; for application code upgrades, us

1시간 설치 수
1
GitHub Stars
10
업데이트
10월 14일
meteor
커뮤니티

meteor-debugging

Use when diagnosing an unexplained failure in a Meteor 3 application before the failing layer or fix is known. Triggers on server crashes, client-only errors, stuck subscriptions, DDP or WebSocket disconnects, Minimongo/server data mismatches, hanging or flaky tests, slow builds, --inspect, console.log, .only, Playwright traces, Instrumentation lifecycle events, or requests to debug a Meteor app. Use this skill when evidence must distinguish Meteor tool, server, client, data, test, browser, mobi

1시간 설치 수
1
GitHub Stars
10
업데이트
10월 14일
meteor
커뮤니티

meteor-methods

Use when authoring or debugging Meteor methods (Meteor.methods, Meteor.call, Meteor.callAsync). Triggers on argument validation with check(), optimistic UI stubs, latency compensation, Meteor.Error handling, and DDPRateLimiter. Use this skill when the user asks about server-side mutation, asks about rate limiting RPC, or asks about wrapping a method with auth checks.

1시간 설치 수
1
GitHub Stars
10
업데이트
10월 14일
meteor
커뮤니티

meteor-pubsub

Use when authoring or debugging Meteor publications and subscriptions (Meteor.publish, Meteor.subscribe). Triggers on publication strategies (SERVERMERGE, NOMERGE, NOMERGENOHISTORY), the low-level publish API (added/changed/removed), cursor authorization, reactive joins, leaked documents. Use this skill when the user asks about pub/sub or asks about reactive data fetching.

1시간 설치 수
1
GitHub Stars
10
업데이트
10월 14일