JetBrains Space是整個(gè)軟件開(kāi)發(fā)pipeline和團(tuán)隊(duì)協(xié)作的統(tǒng)一平臺(tái)。托管git存儲(chǔ)庫(kù)、查看代碼、自動(dòng)化CI/CD、存儲(chǔ)和發(fā)布包、管理問(wèn)題和文檔以及在聊天中進(jìn)行通訊——所有這些功能都集成在一起，開(kāi)箱即用。

Space團(tuán)隊(duì)正在發(fā)布對(duì)部署的支持，這是使Space成為真正的一體化解決方案的 另一個(gè)難題。 部署是一個(gè)空間實(shí)體，表示將源代碼更改交付到部署環(huán)境（部署目標(biāo)）。例如，將 Web 應(yīng)用程序交付到生產(chǎn)服務(wù)器、在商店中發(fā)布移動(dòng)應(yīng)用程序、將分發(fā)上傳到 FTP 服務(wù)器等等。

部署在許多層面上都有幫助：

• 作為用戶：部署可讓您跟蹤代碼更改并回答諸如“哪個(gè)產(chǎn)品版本現(xiàn)在正在生產(chǎn)中？”、“哪個(gè)特定提交用于部署生產(chǎn)版本？”、“之間有多少更改（提交）版本 A 和版本 B？”等。
• 作為一個(gè)團(tuán)隊(duì)：部署使產(chǎn)品發(fā)布生命周期更加透明。由于您有一個(gè)預(yù)定義的部署目標(biāo)列表（例如 Web、桌面、云、移動(dòng)設(shè)備等），因此您始終知道您的產(chǎn)品部署在哪里。部署計(jì)劃可讓您計(jì)劃部署頻率。目標(biāo)健康檢查（尚不可用）將很快顯示特定目標(biāo)的情況。
• 作為一家公司：部署還可以為公司帶來(lái)好處。例如，將空間部署視為定義公司部署目標(biāo)的統(tǒng)一標(biāo)準(zhǔn)。因此，每個(gè)發(fā)布的產(chǎn)品、應(yīng)用程序版本或內(nèi)部服務(wù)更新都會(huì)被記錄和跟蹤。這可以簡(jiǎn)化類似 log4j 場(chǎng)景中的風(fēng)險(xiǎn)管理。在 Space 中定義所有目標(biāo)后，您可以輕松跟蹤交付給最終用戶的庫(kù)版本。

部署如何工作

Space中的部署本身不會(huì)運(yùn)行任何構(gòu)建腳本。它只是一個(gè)跟蹤當(dāng)前部署狀態(tài)的狀態(tài)機(jī)。狀態(tài)更新由 CI/CD 服務(wù)器在空間命令行工具（作為 Docker 映像提供：）public.registry.jetbrains.space/p/space/containers/space-cli:latest或 Space HTTP API 的幫助下發(fā)送。還有一個(gè)選項(xiàng)可以在 UI 中手動(dòng)更改部署狀態(tài)。這意味著您可以將部署與您選擇的任何 CI/CD 工具一起使用，包括 Space Automation、JetBrains TeamCity、GitHub Actions 等。

例如，這就是包含所有可能狀態(tài)的部署的樣子。

此方案中除已完成之外的所有狀態(tài)都是可選的：您可以在任何狀態(tài)下創(chuàng)建新部署。

如何開(kāi)始部署

假設(shè)您有一個(gè)現(xiàn)有的 CI/CD 管道，可以將您的產(chǎn)品交付到某個(gè)環(huán)境（目標(biāo)）。在最簡(jiǎn)單的情況下，您可以從跟蹤部署何時(shí)開(kāi)始（部署狀態(tài)）和何時(shí)結(jié)束（當(dāng)前狀態(tài)）開(kāi)始：

1. 您在 Space 中創(chuàng)建一個(gè)部署目標(biāo)。
2. 你得到一個(gè)空間授權(quán)令牌。您將需要它來(lái)授權(quán)您在 Space 中的 CI/CD 工具。
3. 觸發(fā)器（創(chuàng)建發(fā)布分支、git push、計(jì)劃等）在 CI/CD（例如 Space Automation、TeamCity 或其他工具）上運(yùn)行部署腳本。這是您應(yīng)該向 Space 報(bào)告部署狀態(tài)的地方：
   • （可選）在 CI/CD 服務(wù)器運(yùn)行腳本之前，它會(huì)創(chuàng)建一個(gè)處于部署狀態(tài)的部署，例如，使用空間命令行工具：
     space deployments start $PROJECT_KEY $TARGET_KEY --version $VERSION --commit $COMMIT_ID。盡管此步驟是可選的，但它非常有用，因?yàn)樗黾恿肆鞒痰耐该鞫取Ｍㄖ脩舨渴鹫谶M(jìn)行中。
   • 部署完成后，CI/CD 服務(wù)器必須將其狀態(tài)更改為current，例如，使用space命令行工具：
     space deployments finish $PROJECT_KEY $TARGET_KEY --version $VERSION
     如果您跳過(guò)了上一步，該命令將創(chuàng)建一個(gè)新的當(dāng)前部署。否則，它將更新現(xiàn)有的。詳細(xì)了解如何完成部署。
     
     這可能是空間自動(dòng)化工作中的樣子：

     job("Deploy") {
        // you can store the auth token as a secret
        env["TOKEN"] = Secrets("space-auth-token")
        container("Deploy to prod", "registry.jetbrains.team/p/myprj/docker/custom-image-with-space-cli") {
           shellScript {
              // staging-server is the target key
              // JB_SPACE_EXECUTION_NUMBER serves as a version number
              content = """
                 space configure ${'$'}JB_SPACE_API_URL ${'$'}TOKEN
                 space deployments start ${'$'}JB_SPACE_PROJECT_KEY staging-server --version ${'$'}JB_SPACE_EXECUTION_NUMBER --commit my-web-app:release:${'$'}JB_SPACE_GIT_REVISION
                 ./do-deploy.sh
                  space deployments finish ${'$'}JB_SPACE_PROJECT_KEY staging-server
              """
           }
        }
     }

   • 如果部署失敗，您可以將其狀態(tài)更改為failed with
     space deployments fail $PROJECT_KEY $TARGET_KEY --version $VERSION。我們?yōu)榭臻g自動(dòng)化中的部署提供額外支持。您可以通過(guò)在作業(yè)中使用 Space SDK 直接處理部署。此外，Space Automation 可以自動(dòng)處理部署狀態(tài)。您需要做的就是使用該syncWithAutomationJob參數(shù)開(kāi)始一個(gè)新的部署。它將部署狀態(tài)與作業(yè)運(yùn)行結(jié)果同步：

     job("Deploy") {
        container("Run deploy script", image = "gradle:7.1-jre11") {
           kotlinScript { api ->
              api.space().projects.automation.deployments.start(
                 // get id of the current project
                 project = api.projectIdentifier(),
                 // deployment target name
                 targetIdentifier = TargetIdentifier.Id("production-server"),
                 version = "1.0.0",
                 // with syncWithAutomationJob = true,
                 // Space will automatically change deployment status
                 // based on the job execution result.
                 // If the job fails, the deployment fails as well.
                 // If the job is successful, the deployment becomes 'current'.
                 syncWithAutomationJob = true
              )
              // do deployment staff
              // ...
           }
        }
     }

     腳本成功完成后，部署變?yōu)?current，這意味著這是部署到目標(biāo)環(huán)境的實(shí)際應(yīng)用程序版本。 

4. 部署較新版本后，最新的當(dāng)前版本將自動(dòng)變?yōu)镃ompleted。

   

   基本上，這足以開(kāi)始。隨著時(shí)間的推移，您可以改進(jìn)您的工作流程，例如，在所有其他步驟之前添加部署計(jì)劃。

開(kāi)始使用部署和 TeamCity

TeamCity 工作流程看起來(lái)與上面的工作流程非常相似。通常，對(duì)于部署，您使用Deployment 構(gòu)建配置。在此配置中，添加兩個(gè)構(gòu)建步驟，如下所示：

• 在實(shí)際部署步驟之前添加一個(gè)。它必須在部署狀態(tài)下創(chuàng)建部署。
• 在部署步驟之后添加另一個(gè)。它必須將部署狀態(tài)更改為current。

構(gòu)建配置可能如下所示：

steps {
       script {
           name = "Space notification - start deployment"
           scriptContent = """
                   space configure %env.SPACE_DEPLOYMENT_API_URL% %env.SPACE_NOTIFICATION_PERM_TOKEN%
                   space deployments start %env.SPACE_DEPLOYMENT_PROJECT_KEY% %env.SPACE_DEPLOYMENT_TARGET_ID% --version %build.number% --commit my-web-app:%teamcity.build.branch%:%build.vcs.number% --ext-service '%env.SPACE_DEPLOYMENT_EXT_SERVICE%' --ext-label '%env.SPACE_DEPLOYMENT_EXT_LABEL%' --ext-url %env.SPACE_DEPLOYMENT_EXT_URL%
               """
           dockerImage = "%env.SPACE_CLI_DOCKER_IMAGE%"
       }
       script {
           // do deploy...
       }
       script {
           name = "Space notification - finish deployment"
           executionMode =  BuildStep.ExecutionMode.ON_SUCCESS
           scriptContent = """
                   space configure %env.SPACE_DEPLOYMENT_API_URL% %env.SPACE_NOTIFICATION_PERM_TOKEN%
                   space deployments finish %env.SPACE_DEPLOYMENT_PROJECT_KEY% %env.SPACE_DEPLOYMENT_TARGET_ID%
               """
           dockerImage = "%env.SPACE_CLI_DOCKER_IMAGE%"
       }
       script {
           name = "Space notification - fail deployment"
           executionMode =  BuildStep.ExecutionMode.ON_FAILURE
           scriptContent = """
                   space configure %env.SPACE_DEPLOYMENT_API_URL% %env.SPACE_NOTIFICATION_PERM_TOKEN%
                   space deployments fail %env.SPACE_DEPLOYMENT_PROJECT_KEY% %env.SPACE_DEPLOYMENT_TARGET_ID% 
               """
           dockerImage = "%env.SPACE_CLI_DOCKER_IMAGE%"
       }
   }

與Space整合

部署目標(biāo)時(shí)間表

部署與其他空間子系統(tǒng)集成的方式是另一個(gè)重要因素。首先，每個(gè)部署目標(biāo)和部署都有自己的時(shí)間表，用于發(fā)布部署狀態(tài)更改。您還可以訂閱部署事件并在您的個(gè)人Spacebox頻道中接收通知。

部署時(shí)間表

部署也有時(shí)間表。此外，部署時(shí)間表不僅僅是一個(gè)日志——它還是一個(gè)專用的聊天頻道，您可以在其中與團(tuán)隊(duì)或公司中參與 CD 的其他人進(jìn)行交流。

與 VCS 和問(wèn)題的集成

提交現(xiàn)在具有部署選項(xiàng)卡，可讓您查看提交是否已部署。合并請(qǐng)求和問(wèn)題也有一個(gè)類似的部署選項(xiàng)卡。

下一步是什么

• 空間自動(dòng)化管道：部署后的下一個(gè)主要步驟。部署只跟蹤預(yù)定義的狀態(tài)，而管道可能包括任意數(shù)量的自定義階段。管道將為流程帶來(lái)更多控制：進(jìn)入下一階段的條件以及回滾部署或從 Space 觸發(fā)新部署的能力。您可以選擇使用 Space Automation 運(yùn)行管道，或者僅在 Space 中定義管道并使用外部 CI/CD 工具運(yùn)行所有步驟。
• 部署目標(biāo)運(yùn)行狀況檢查：您可以選擇跟蹤實(shí)際部署狀態(tài)。Space 將定期檢查部署目標(biāo)的健康狀態(tài)并報(bào)告任何事件。

更多有關(guān)Space產(chǎn)品信息可以咨詢 。

Space技術(shù)交流群：786598704       歡迎進(jìn)群一起討論