JetBrains Space是整個軟件開發pipeline和團隊協作的統一平臺。托管git存儲庫、查看代碼、自動化CI/CD、存儲和發布包、管理問題和文檔以及在聊天中進行通訊——所有這些功能都集成在一起，開箱即用。

Space團隊正在發布對部署的支持，這是使Space成為真正的一體化解決方案的 另一個難題。 部署是一個空間實體，表示將源代碼更改交付到部署環境（部署目標）。例如，將 Web 應用程序交付到生產服務器、在商店中發布移動應用程序、將分發上傳到 FTP 服務器等等。

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

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

部署如何工作

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

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

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

如何開始部署

假設您有一個現有的 CI/CD 管道，可以將您的產品交付到某個環境（目標）。在最簡單的情況下，您可以從跟蹤部署何時開始（部署狀態）和何時結束（當前狀態）開始：

1. 您在 Space 中創建一個部署目標。
2. 你得到一個空間授權令牌。您將需要它來授權您在 Space 中的 CI/CD 工具。
3. 觸發器（創建發布分支、git push、計劃等）在 CI/CD（例如 Space Automation、TeamCity 或其他工具）上運行部署腳本。這是您應該向 Space 報告部署狀態的地方：
   • （可選）在 CI/CD 服務器運行腳本之前，它會創建一個處于部署狀態的部署，例如，使用空間命令行工具：
     space deployments start $PROJECT_KEY $TARGET_KEY --version $VERSION --commit $COMMIT_ID。盡管此步驟是可選的，但它非常有用，因為它增加了流程的透明度。通知用戶部署正在進行中。
   • 部署完成后，CI/CD 服務器必須將其狀態更改為current，例如，使用space命令行工具：
     space deployments finish $PROJECT_KEY $TARGET_KEY --version $VERSION
     如果您跳過了上一步，該命令將創建一個新的當前部署。否則，它將更新現有的。詳細了解如何完成部署。
     
     這可能是空間自動化工作中的樣子：

     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
              """
           }
        }
     }

   • 如果部署失敗，您可以將其狀態更改為failed with
     space deployments fail $PROJECT_KEY $TARGET_KEY --version $VERSION。我們為空間自動化中的部署提供額外支持。您可以通過在作業中使用 Space SDK 直接處理部署。此外，Space Automation 可以自動處理部署狀態。您需要做的就是使用該syncWithAutomationJob參數開始一個新的部署。它將部署狀態與作業運行結果同步：

     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
              // ...
           }
        }
     }

     腳本成功完成后，部署變為current，這意味著這是部署到目標環境的實際應用程序版本。 

4. 部署較新版本后，最新的當前版本將自動變為Completed。

   

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

開始使用部署和 TeamCity

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

• 在實際部署步驟之前添加一個。它必須在部署狀態下創建部署。
• 在部署步驟之后添加另一個。它必須將部署狀態更改為current。

構建配置可能如下所示：

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整合

部署目標時間表

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

部署時間表

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

與 VCS 和問題的集成

提交現在具有部署選項卡，可讓您查看提交是否已部署。合并請求和問題也有一個類似的部署選項卡。

下一步是什么

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

更多有關Space產品信息可以咨詢 。

Space技術交流群：786598704       歡迎進群一起討論