在GitLab CI / CD上使用SSH密钥

您所在的位置:网站首页 gitlab生成一个ssh密钥 在GitLab CI / CD上使用SSH密钥

在GitLab CI / CD上使用SSH密钥

2023-07-21 08:18| 来源: 网络整理| 查看: 265

亚搏体育app文件 亚搏体育app CI / CD 在GitLab CI / CD上使用SSH密钥 在GitLab CI / CD上使用SSH密钥 上次更新时间:2017-12-13• Using SSH keys with GitLab CI/CD

GitLab当前不支持在构建环境(运行GitLab Runner的环境)中管理SSH密钥的内置支持。

SSH密钥在以下情况下很有用:

您想签出内部子模块 您想使用包管理器(例如Bundler)下载私有包 您想要将应用程序部署到自己的服务器上,例如Heroku 您要执行从构建环境到远程服务器的SSH命令 您想将文件从构建环境同步到远程服务器

如果上述任何事情都响了,那么您很可能需要SSH密钥。

支持最广泛的方法是通过扩展.gitlab-ci.yml,将SSH密钥注入到构建环境中,并且该解决方案可与任何类型的执行程序 (Docker,shell等)一起使用。

这个怎么运作 使用以下命令在本地创建新的SSH密钥对 ssh-keygen 将私钥作为变量添加到您的项目中 运行ssh-agent期间作业以加载私钥。 将公共密钥复制到您想要访问的服务器上(通常在中 ~/.ssh/authorized_keys),或者 在访问私有GitLab存储库时将其添加为部署密钥。 注意: 除非您启用 调试日志 记录,否则私钥将不会显示在作业日志中 。您可能还需要检查 管道 的可见性。 使用Docker执行器时的SSH密钥

当您的CI / CD作业在Docker容器中运行(意味着包含环境)并且您想要在私有服务器中部署代码时,您需要一种访问它的方法。这是SSH密钥对派上用场的地方。

您首先需要创建一个SSH密钥对。有关更多信息,请按照说明生成SSH密钥。 请勿在SSH密钥中添加密码,否则before_script会提示您输入密码。

创建一个新变量。在“ 密钥”中输入名称,SSH_PRIVATE_KEY然后在“ 值”字段中粘贴先前创建的私钥的内容。

修改您.gitlab-ci.yml的before_script操作。在以下示例中,假定使用基于Debian的图像。根据需要进行编辑:

before_script: ## ## Install ssh-agent if not already installed, it is required by Docker. ## (change apt-get to yum if you use an RPM-based image) ## - 'command -v ssh-agent >/dev/null || ( apt-get update -y && apt-get install openssh-client -y )' ## ## Run ssh-agent (inside the build environment) ## - eval $(ssh-agent -s) ## ## Add the SSH key stored in SSH_PRIVATE_KEY variable to the agent store ## We're using tr to fix line endings which makes ed25519 keys work ## without extra base64 encoding. ## https://gitlab.com/gitlab-examples/ssh-private-key/issues/1#note_48526556 ## - echo "$SSH_PRIVATE_KEY" | tr -d '\r' | ssh-add - ## ## Create the SSH directory and give it the right permissions ## - mkdir -p ~/.ssh - chmod 700 ~/.ssh ## ## Optionally, if you will be using any Git commands, set the user name and ## and email. ## #- git config --global user.email "[email protected]" #- git config --global user.name "User name" 注: 在 before_script 可以全局或每一个作业设置。

确保专用服务器的SSH主机密钥已验证。

作为最后一步,加上公众从你的第一步,你想拥有从构建环境中的接入服务创建的一个关键。如果要访问私有的GitLab存储库,则需要将其添加为部署密钥。

而已!现在,您可以在构建环境中访问私有服务器或存储库。

使用Shell执行程序时的SSH密钥

如果您使用的是Shell执行程序而不是Docker,则设置SSH密钥会更加容易。

您可以从安装了GitLab Runner的计算机生成SSH密钥,并将该密钥用于在该计算机上运行的所有项目。

首先,登录到运行您的作业的服务器。

然后,从终端以gitlab-runner用户身份登录:

sudo su - gitlab-runner

按照说明生成SSH密钥对,以 生成SSH密钥。 请勿在SSH密钥中添加密码,否则before_script会提示您输入密码。

作为最后一步,加上公众从前面创建要具有从构建环境中的接入服务的一个关键。如果要访问私有的GitLab存储库,则需要将其添加为 部署密钥。

完成后,尝试登录到远程服务器以接受指纹:

ssh example.com

要访问GitLab.com上的存储库,可以使用[email protected]

验证SSH主机密钥

最好检查私有服务器自己的公用密钥,以确保您不会受到中间人攻击的攻击。万一发生任何可疑事件,您将注意到它,因为作业将失败(如果公钥不匹配,则SSH连接将失败)。

要查找服务器的主机密钥,请ssh-keyscan从受信任的网络(最好从专用服务器本身)运行命令:

## Use the domain name ssh-keyscan example.com ## Or use an IP ssh-keyscan 1.2.3.4

创建一个新变量,将其 SSH_KNOWN_HOSTS作为“键”,并作为“值”添加的输出ssh-keyscan。

注意: 如果需要连接到多个服务器,则所有服务器主机密钥都需要收集在变量的 Value 中,每行一个密钥。 提示: 通过使用变量而不是 ssh-keyscan 直接在变量内部 .gitlab-ci.yml ,它具有以下优点: .gitlab-ci.yml 如果主机域名由于某些原因而更改,则不必更改。而且,这些值是由您预定义的,这意味着如果主机密钥突然更改,CI / CD作业将失败,并且您将知道服务器或网络出了点问题。

现在SSH_KNOWN_HOSTS已经创建了变量,除了 上面的 内容.gitlab-ci.yml之外,还需要添加以下内容:

before_script: ## ## Assuming you created the SSH_KNOWN_HOSTS variable, uncomment the ## following two lines. ## - echo "$SSH_KNOWN_HOSTS" >> ~/.ssh/known_hosts - chmod 644 ~/.ssh/known_hosts ## ## Alternatively, use ssh-keyscan to scan the keys of your private server. ## Replace example.com with your private server's domain name. Repeat that ## command if you have more than one server to connect to. ## #- ssh-keyscan example.com >> ~/.ssh/known_hosts #- chmod 644 ~/.ssh/known_hosts ## ## You can optionally disable host key checking. Be aware that by adding that ## you are susceptible to man-in-the-middle attacks. ## WARNING: Use this only with the Docker executor, if you use it with shell ## you will overwrite your user's SSH config. ## #- '[[ -f /.dockerenv ]] && echo -e "Host *\n\tStrictHostKeyChecking no\n\n" >> ~/.ssh/config' 示例项目

为了方便起见,我们建立了一个示例SSH项目,使用我们的公共 共享运行程序在GitLab.com上运行。

想要破解吗?只需对其进行分叉,提交并推送您的更改。稍后,公共跑步者将选择更改并开始工作。



【本文地址】


今日新闻


推荐新闻


CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3