seecoder-devcloud/api/src/main/java/seecoder/devcloud/api/k8s/ExecApi.java

package seecoder.devcloud.api.k8s;


import seecoder.devcloud.api.k8s.exception.K8sApiException;

import java.util.List;

/**
 * 进入容器执行指令
 *
 * @todo 传入输入流，获得输出流
 */
public interface ExecApi {

    /**
     * 选择namespace下podName中的containerName的容器执行commands指令
     * @param namespace
     * @param podName
     * @param containerName
     * @param commands
     * @return exitCode=0 则返回true，其它情况返回false
     * @throws K8sApiException NOT_FOUND 命名空间/pod/container不存在
     * @throws K8sApiException SYSTEM_ERROR 系统异常
     */
    boolean exec(String namespace, String podName, String containerName, List<String> commands);

    /**
     * 当且仅当pod下只有一个container时，该指令才会执行成功，否则会抛出异常
     * @param namespace
     * @param podName
     * @param commands
     * @return exitCode=0 则返回true，其它情况返回false
     * @throws K8sApiException NOT_FOUND 命名空间不存在/pod不存在/pod下没有container
     * @throws K8sApiException SYSTEM_ERROR pod存在多个container/系统异常/指令执行异常
     */
    boolean exec(String namespace, String podName, List<String> commands);

    Process getTerminal(String namespace, String podName);
}