文档

实例命令行操作

更新时间:

您可通过函数计算控制台或SDK来登录函数实例内部,并执行相应的命令行操作。本文介绍如何在控制台登录函数实例并执行相应命令。

背景信息

实例是请求的执行环境,请求开始执行前,函数计算会为每个请求分配一个最合适的实例,请求执行结束会将空闲实例释放。实例命令行操作功能能够支持在实例的真实运行环境中执行指定命令,例如登录进入实例查看实例环境信息,或者使用Profiling或Coredump等工具收集上下文信息来优化性能等。

使用说明

  • 只能对存活状态的实例(包括预留模式的常驻实例和按量模式的活跃实例)执行实例命令行操作。如果按量模式的实例空闲超时被释放或实例处于不健康状态即将被销毁,可能无法登录实例执行操作。

  • 实例命令行操作的请求不占用实例的并发度,因此即使函数的实例并发度设置为1,也可以同时执行调用函数和实例命令行操作。

  • 一次实例命令行操作被视作一次函数调用。只要实例命令行操作请求建立的WebSocket连接没有和函数实例断开,那么函数实例将一直处于活跃状态,和调用函数采用同样的计量规则。通过控制台操作时,如果控制台登录实例界面没有数据传输,则函数实例默认会在空闲10分钟后断开连接。

  • 如果您使用的运行时为Custom Container自定义镜像,请确保容器中有/bin/bash目录或/bin/sh目录,否则无法启动实例终端。

说明

对正在执行线上请求的实例发起实例命令行操作,线上环境的变化可能导致实例上正在执行的任务失败,并直接影响该实例后续任务的成功率。如因实例命令行操作导致请求执行失败,将不会统计到产品SLA中。

前提条件

操作步骤

  1. 登录函数计算控制台,在左侧导航栏,单击函数

  2. 在顶部菜单栏,选择地域,然后在函数页面,单击目标函数。

  3. 在函数配置页面,选择实例页签。

  4. 在实例列表中,找到目标实例ID,然后在其操作列,单击登录实例

  5. 在弹出的提示对话框中,认真阅读提示并确认无误后,单击我已知晓风险

    页面跳转至登录后的实例命令行页面,您可按需执行相应命令。

说明

只支持登录状态为运行中的实例来进行命令行操作,如果实例已销毁,将无法登录。