Monitoring Google Cloud 執行

CommonJS

將下列行新增至 Dockerfile 最後一個 FROM 子句之後的任何位置:

COPY --from=icr.io/instana/google-cloud-run-nodejs:latest /instana /instana
RUN /instana/setup.sh
ENV NODE_OPTIONS="--require /instana/node_modules/@instana/google-cloud-run"

ECMAScript 模組

將下列行新增至 Dockerfile 最後一個 FROM 子句之後的任何位置:

COPY --from=icr.io/instana/google-cloud-run-nodejs:latest /instana /instana
RUN /instana/setup.sh
ENV NODE_OPTIONS="--experimental-loader=/instana/node_modules/@instana/google-cloud-run/esm-loader.mjs"

建置容器，並將它推送至您選擇的映像檔儲存庫。

最後，遵循 配置雲端執行服務一節中說明的配置步驟。

附註：

• 如果您使用 多階段建置 (亦即，如果您在 Dockerfile中具有多個 FROM 子句) ，則需要在 Dockerfile的最後一個 FROM 子句中新增下列行。
• 不支援在「雲端執行」中執行之 Node.js 處理程序的 自動設定檔 。

版本化

不論現行主要版本為何， icr.io/instana/google-cloud-run-nodejs:latest 都會使用最新可用的映像檔版本。 例如，如果發行新的主要版本 v4 ，且目前您的映像檔版本是 v3，則在下一次重建時，如果您使用標籤 ":latest" ，則映像檔會自動更新為 v4 。

附註:如果您不想要該行為，請使用特定主要映像檔版本 (例如 icr.io/instana/google-cloud-run-nodejs:1 (v1)) ，並手動更新至下一個主要版本。

• 如需相關資訊，請參閱 Node.js 版本化。

建置相依關係和原生附加程式

如果您對 Node.js 容器使用相當基本的基本映像檔，但該容器沒有建置原生 Node.js 附加程式所需的套件，您可能會在 Docker 建置中看到如下的警告:

gyp ERR! ...some error message from trying to rebuild native add-ons, for example:
gyp ERR! stack Error: Could not find any Python installation to use
...
Warning: Rebuilding native add-ons for @instana/google-cloud-run failed. Monitoring the Cloud Run service revision instance will work nonetheless, but you will miss some Node.js metrics (GC metrics, event loop metrics, ...). See https://www.instana.com/docs/ecosystem/google-cloud-run/#build-dependencies-and-native-add-ons for details.

如日誌訊息所示，監視 Node.js Cloud Run service revision instance with Instana 可運作。 但遺漏某些度量值。 Instana 建議在建置期間至少暫時安裝遺漏的作業系統套件。 它們不需要包含在最終映像檔中。 要安裝哪些套件，以及如何安裝它們，視您使用的發行套件而定。

請參閱下列適用於 Linux® Alpine的範例 Dockerfile Snippet:

COPY --from=icr.io/instana/google-cloud-run-nodejs:latest /instana /instana
RUN apk add --no-cache --virtual .gyp \
        build-base \
        python \
    && /instana/setup.sh \
    && apk del .gyp python
ENV NODE_OPTIONS="--require /instana/node_modules/@instana/google-cloud-run"

請參閱下列 Debian 型發行套件範例 (包括 Ubuntu):

COPY --from=icr.io/instana/google-cloud-run-nodejs:latest /instana /instana
RUN apt-get update \
    && apt-get install build-essential \
    && /instana/setup.sh \
    && apt-get remove -y build-essential
ENV NODE_OPTIONS="--require /instana/node_modules/@instana/google-cloud-run"

對於使用 yum (CentOS、RHEL ...) 的發行套件， 用來安裝必要套件的指令如下:

RUN yum groupinstall "Development Tools"

從 containers.instana.io 取得 Node.js Layer

如果您也搭配使用 Instana 的「雲端執行」支援與其他執行時期 (例如 Java) ，且映像檔層只能在已鑑別登錄 containers.instana.io上使用，且您想要讓事物保持一致，則也可以從 containers.instana.io 而非公用 IBM 容器登錄取得 Node.js Instana Cloud Run 映像檔層，作為上述方法的替代方案。

由於 containers.instana.io 登錄需要鑑別，您需要先執行下列指令，才能在 Docker 建置中使用它:

docker login -u _ -p <your-agent-key> containers.instana.io

位置保留元 <your-agent-key> 需要取代為實際的 Instana 代理程式金鑰。 這需要在您建置 Docker 映像檔的機器上完成。

將下列行新增至 Dockerfile 最後一個 FROM 子句之後的任何位置:

COPY --from=containers.instana.io/instana/release/google/cloud-run/nodejs:latest /instana /instana
RUN /instana/setup.sh
ENV NODE_OPTIONS="--require /instana/node_modules/@instana/google-cloud-run"