JFrog

    云客户?
    免费开始>
    在MyJFrog >中升级
    云有什么新>






    跳到元数据的末尾
    进入元数据的开始

    概述

    的LinuxVMDeploy本机步骤上传文件到虚拟机VmCluster资源，对虚拟机执行命令。如果所有部署都成功，则部署构件的副本将存储在${回家}/ $ {step_name} /回滚在每个虚拟机上。文件可以在文件规范，BuildInfo或ReleaseBundle．

    从Bash派生的标记

    所有本机步骤都派生自Bash的一步。这意味着所有步骤共享来自Bash的相同基本标记集，而本机步骤也有自己的附加标记，这些标记支持该步骤的特定功能。所以熟悉这个很重要Bash步骤定义，因为它是所有其他步骤定义的核心。

    页面内容

    YAML模式

    LinuxVMDeploy原生步骤的YAML模式如下:

    LinuxVMDeploy 
    管道:—name:  steps:—name: myLinuxVMDeployStep type: LinuxVMDeploy configuration: environmentVariables: dry_run:  # optional deploy_targets_override:  # optional targetDirectory:  # optional rolloutDelaySecs:  # optional fastFail:  # optional sshUser:  # required vmEnvironmentVariables:  # optional strategy: <"rollingUpdate"|"blueGreen"> # optional;默认“rollingUpdate”inputResourc2022世界杯阿根廷预选赛赛程es: - name:  # 1必需(正好1，正好2对于blueGreen策略)。- name:  # required(正好是1). scripts: - name:  # required context: <"buildNode"|"targetCluster"|"currentCluster"> # required， "currentCluster"只支持blueGreen。命令: # optional

    标签

    的名字

    一个字母数字字符串(允许使用下划线)，用于标识步骤。

    类型

    必须LinuxVMDeploy对于这个步骤类型。

    配置

    指定步骤执行环境的所有配置选择。该步骤继承Bash/PowerShell步骤配置标签，包括这些相关的标签:

    标签

    使用说明

    必需的/可选
    集成 必须指定VmCluster资源。 要求
    input2022世界杯阿根廷预选赛赛程Resources

    必须指定一个文件规范，BuildInfo或ReleaseBundle包含要上传的文件的资源。必须指定一个。

    		 要求

    从Bash派生的标记

    所有本机步骤都派生自Bash的一步。这意味着所有步骤共享来自Bash的相同基本标记集，而本机步骤也有自己的附加标记，这些标记支持该步骤的特定功能。所以熟悉这个很重要Bash步骤定义，因为它是所有其他步骤定义的核心。


    此外，可以定义这些标记来支持该步骤的本机操作:

    标签

    使用说明

    		 必需的/可选
    sshUser 用于连接目标虚拟机的ssh用户。 要求
    targetDirectory

    上传部署构件的目录路径。如果目录不存在，则创建该目录。

    默认目录为< sshUser $ HOME > / step_name / run_id美元．

    		 可选

    vmEnvironmentVariables

    		 这些变量将被导出到目标虚拟机中。 可选
    rolloutDelaySecs

    部署之间等待的时间以秒为单位。

    		 可选
    fastFail

    如果真正的，该步骤将不会在第一次失败后部署到其他虚拟机。

    默认是真正的．

    		 可选
    策略

    要使用的发布策略。两者都有可能rollingUpdate或blueGreen．

    • rollingUpdate:依次部署到一个集群中的每个虚拟机。
    • blueGreen:部署到两个中的一个VmCluster2022世界杯阿根廷预选赛赛程每次LinuxVMDeploy步骤运行时交换集群。
    		 可选
    脚本

    在给定上下文上运行的用户定义命令。

    • 的名字：命令的名称。
    • 上下文：脚本应该在哪里运行。buildNode在构建节点上运行。targetCluster运行在提供的vmCluster上。


    		 要求


    环境变量

    以下环境变量可用于在LinuxVMDeploy步骤中编写的用户定义脚本。

    的名字 使用说明
    target_cluster
    		 部署到的虚拟机集群名称。
    current_cluster

    上次部署到的虚拟机集群名称。

    支持blueGreen策略。
    current_command 退出步骤时正在运行的命令的名称。如果没有用户定义的命令正在运行，该选项应该为空。


    执行

    声明在执行前和执行后阶段执行的shell命令序列集合:

    标签 使用说明 必需的/可选
    onStart 在本机操作之前执行的命令 可选
    调用onSuccess 成功完成后执行的命令 可选
    onFailure 在完成失败时执行的命令 可选
    onComplete 在任何补全时执行的命令 可选

    对象执行的操作onExecute阶段是此步骤类型固有的，不能被覆盖。

    保留关键字

    onExecute，onStart，调用onSuccess，onFailure,onComplete是保留的关键字。在执行脚本的任何其他上下文中使用这些关键字都可能导致意外行为。

    例子

    下面的示例展示了配置LinuxVMDeploy步骤的几种方法。

    将FileSpec资源中的应用上传至虚拟机并运行

    LinuxVMDeploy的最基本形式。使用所有默认值。该步骤将上传文件到默认文件targetDirectory并运行部署命令。

    LinuxVMDeploy 
    2022世界杯阿根廷预选赛赛程resources:—name: myApplication type: FileSpec configuration: sourceArtifactory: myArtifactory pattern: "example-repo-local/myApp"—name: myVM type: VmCluster configuration: sshKey: mySSHKey targets:—0.0.0.0—1.1.1.1 pipelines:—name: linuxVMDeployPipeline steps:—name: linuxVMDeploy type: linuxVMDeploy configuration: inputResources:—name: myVM - name: myApplication scripts:—name: deploydcommand context: targetCluster commands: - "./myApp"

    将BuildInfo资源中的应用上传至虚拟机、执行postDeploy命令、回退处理。

    上传BuildInfo资源和尝试运行deployCommand而且postDeploy命令。如果deployCommand如果成功，则postDeploy将运行。虚拟机故障(如果命令或postDeploy没有成功),然后rollbackCommand将在任何成功部署的虚拟机上运行。

    LinuxVMDeploy 
    2022世界杯阿根廷预选赛赛程resources:—name: myApplication type: BuildInfo configuration: sourceArtifactory: myArtifactory buildName: myBuild buildNumber: 1—name: myVM type: VmCluster configuration: sshKey: mySSHKey targets:—0.0.0.0—1.1.1.1 pipelines:—name: linuxVMDeployPipeline steps:—name: linuxVMDeploy type: linuxVMDeploy configuration: inputResources:—name: myVM—name: myApplication sshUser: myUser scripts:—name: deployCommand context: targetCluster commands: - "。/myApp" onFailure: - 'if ["$current_command" == "deployCommand"];/doRollback.sh fi'

    覆盖VmCluster目标

    在这个例子中，aVmCluster资源与deploy_targets_override环境变量。中指定的目标将部署工件deploy_targets_override．VmCluster资源中的ssh密钥仍将被使用。

    LinuxVMDeploy 
    2022世界杯阿根廷预选赛赛程resources:—name: myApplication type: FileSpec configuration: sourceArtifactory: myArtifactory pattern: "example-repo-local/myApp"—name: myVM type: VmCluster configuration: sshKey: s_VM_DEPLOY_SSHKEY targets:—0.0.0.0—1.1.1.1 pipelines:—name: linuxVMDeployPipeline steps:—name: linuxVMDeploy type: linuxVMDeploy configuration: environmentVariables: deploy_targets_override: "123.456.78.90,127.0.0.1" inputResources:—name: myVM—name: myApplication sshUser: myUser scripts:—name:部署命令上下文:targetCluster命令:- "./myApp"

    将环境变量传递给虚拟机运行的命令

    在这个例子中，aVmCluster资源由vmEnvironmentVariables．上运行的用户定义命令可以使用这些变量targetCluster．

    LinuxVMDeploy 
    2022世界杯阿根廷预选赛赛程resources:—name: myApplication type: FileSpec configuration: sourceArtifactory: myArtifactory pattern: "example-repo-local/myApp"—name: myVM type: VmCluster configuration: sshKey: s_VM_DEPLOY_SSHKEY targets:—0.0.0.0—1.1.1.1 pipelines:—name: linuxVMDeployPipeline steps:—name: linuxVMDeploy type: linuxVMDeploy configuration: vmEnvironmentVariables:—"LOG_LEVEL=DEBUG" inputResources:—name: myVM—name: myApplication sshUser: myUser scripts:—name: deployCommand context:targetCluster命令:- "。/ myApp LOG_LEVEL美元”

    建立一个blueGreen部署策略

    在这个例子中，是两个VmCluster2022世界杯阿根廷预选赛赛程资源供应和战略blueGreen都是确定的。每走一步，targetCluster而且currentCluster在两个提供的VmCluster资源之间交换。2022世界杯阿根廷预选赛赛程

    LinuxVMDeploy 
    2022世界杯阿根廷预选赛赛程resources:—name: myApplication type: FileSpec configuration: sourceArtifactory: myArtifactory pattern: example-repo-local/myApp—name: myVM type: VmCluster configuration: sshKey: s_VM_DEPLOY_SSHKEY targets:—0.0.0.0—1.1.1.1 pipelines:—name: linuxVMDeployPipeline steps:—name: linuxVMDeploy type: linuxVMDeploy configuration: vmEnvironmentVariables:—LOG_LEVEL=DEBUG inputResources:—name: myBlueCluster—name: myGreenCluster—name: myApplication sshUser: myUser strategy:blueGreen脚本:—名称:deployhost命令上下文:targetCluster命令:—“。”/ myApp LOG_LEVEL美元”- name: cleanupCommand context: currentCluster commands: - "./stopApp" - name: swapCluster context: buildNode commands: - "./swapLoadBalancer $target_cluster"

    工作原理

    当你使用LinuxVMDeploy管道中的本机步骤，它在后台执行以下功能:

    • jfrog rt下载(从FileSpec, BuildInfo或ReleaseBundle下载文件)
    • tar(压缩所有上传至虚拟机的文件)
    • scp(上传压缩工件到虚拟机)
    • ssh"mkdir -p"(如果不存在，创建targetDirectory)
    • 脚本命令通过ssh在目标vm上运行，如果context是"buildNode"，则在构建节点上运行。
      • 命令按照它们在yaml中编写的顺序运行。
      • 在目标集群上运行的命令可以访问vmEnvironmentVariables中定义的变量。
      • 在targetCluster上创建回滚存档(仅在整个步骤成功时发生)
        • 回滚路径:“/home/$ssh_user/LinuxVMDeploy/ Rollback”
        • Mkdir -p(如果不存在则创建回滚目录)。
        • rm -rf $rollbackDirectory/*(删除任何旧的回滚工件)
        • cp -r $targetDirectory/* $rollbackDirectory(复制所有上传的工件到回滚存档)
    • 没有标签
    版权所有©2023 JFrog Ltd。