與Docker建造跨平台CI/CD動作

上週，我被頭痛擊中 - 我們完美調整的lingo.dev github Actions Workflow無法在貢獻者的gitlab實例上運行。然後，我意識到，無論平台如何，我實際上都想在任何地方運行相同的自動化。

>因此，我進行了一個任務，以構建在Github，Gitlab和Bitbucket上運行的跨平台CI自動化（也可能還有其他！）。該解決方案最初是一種簡單的github操作，但在我們需要支持多個代碼託管平台時發展成為功能更強大的東西。

我將帶您完成確切的過程：

開始簡單，我將展示GitHub Action的工作

升級以構建可重複使用的docker image

>最後，我將向您展示如何在每個平台上運行此操作

>按照步驟構建和運送您的第一個跨平台動作。或為文章添加書籤以
3. tl; dr請參閱模板存儲庫???

1。啟動簡單：在github操作中運行javascript

運行github動作

讓我們從最簡單的github操作開始 - 一個運行JavaScript文件的操作。首先，在您的存儲庫的根部創建index.js：

>

現在創建一個工作流文件.github/workflows/hello.yml：

這個動作將：

console.log("Hello World");

觸發到主要分支

>查看您的存儲庫

name: Hello World
on:
  push:
    branches:
      - main

jobs:
  hello:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: "20"
      - name: Say Hello
        run: node index.js

>設置node.js環境

運行腳本
2. 使其可重複使用
現在，讓我們通過將其移動到單獨的存儲庫來重複使用此操作。使用這些文件創建一個新的github存儲庫（例如，像我的示例一樣hello-world-action）：
4. index.js（與之前相同）：

Action.yml：

>現在您可以通過在工作流中引用任何存儲庫中的此操作：>

console.log("Hello World");

關鍵差異是：

動作以自己的存儲庫生活

name: "Hello World Action"
description: "A simple action that says hello"
runs:
  using: "node20"
  main: "index.js"

Action.yml定義如何運行動作

其他存儲庫可以使用以下用途來引用它：your-username/hello-world-action@ref

name: Use Hello Action
on:
  push:
    branches:
      - main

jobs:
  hello:
    runs-on: ubuntu-latest
    steps:
      - name: Say Hello
        uses: your-username/hello-world-action@main

2。升級：dockerized打字稿操作

現在，讓我們創建一個更複雜的操作，以運行打字稿代碼。我們需要幾個文件：
>初始化項目並設置打字稿：

>更新您的軟件包。

1. 然後，將我們的index.js重命名為index.ts使用Typescript代替JavaScript並將其移動到SRC目錄。

   
   

   pnpm init                # Creates package.json
   pnpm add -D typescript   # Install TypeScript as dev dependency
   
   

   >創建tsconfig.json以配置打字稿彙編：>

2. 
   

   創建一個dockerfile：

   {
     "scripts": {
       "build": "tsc"
     }
   }
   
   

console.log("Hello World");

1. >重新定義動作中的動作：yml：

name: Hello World
on:
  push:
    branches:
      - main

jobs:
  hello:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: "20"
      - name: Say Hello
        run: node index.js

在本地運行Docker圖像

>要在本地dockerfile中構建並運行圖像，您需要Docker Desktop應用程序。然後，假設Docker在本地運行，您可以：

1. 構建圖像：

console.log("Hello World");

1. >運行它：

name: "Hello World Action"
description: "A simple action that says hello"
runs:
  using: "node20"
  main: "index.js"

3。跨平台支持

現在是最有趣的部分 - 在其他平台上運行您的操作。我們需要：

1. >構建並將我們的Docker圖像推到註冊表
>
2. >用平台特定的配置引用它

建築和出版Docker圖像

首先，創建一個工作流程以在每個版本上構建和推動Docker映像。我們將使用您的github隨附的GitHub容器註冊表（GHCR）（公共存儲庫免費，500MB用於免費計劃的私人存儲庫）。
>

name: Use Hello Action
on:
  push:
    branches:
      - main

jobs:
  hello:
    runs-on: ubuntu-latest
    steps:
      - name: Say Hello
        uses: your-username/hello-world-action@main

github動作

要在另一個存儲庫的github操作中使用此操作，請在.github/workflows/hello..yml中創建一個工作流文件（請參閱GitHub Actions WorkFlow語法文檔）：
>

pnpm init                # Creates package.json
pnpm add -D typescript   # Install TypeScript as dev dependency

>僅需在github操作上執行此操作，則無需構建和推動Docker映像。 github操作將直接從操作中指定的dockerfile直接構建docker容器。這更有效，因為它避免了推動和從容器註冊表中拉出的額外步驟。但是，如果您打算在Gitlab或Bitbucket等其他CI平台上使用此操作，則需要發佈如上圖所示的Docker映像。

GitHub的免費計劃提供了三個平台之間最慷慨的CI/CD分鐘分配。它包括：

>公共存儲庫的無限分鐘
>私人存儲庫的每月2,000分鐘

GitLab CI配置

create .gitlab-ci.yml（請參閱Gitlab CI/CD文檔）：>

>您的gitlab免費計劃包括每月400 CI/C的計算分鐘，無論存儲庫是公共的還是私人的。

{
  "scripts": {
    "build": "tsc"
  }
}

>

Bitbucket管道

create bitbucket-pipelines.yml（請參閱Bitbucket Pipeelines文檔）：

Bitbucket的免費計劃每月僅包括50分鐘的構建分鐘，而不管存儲庫是公共還是私人，這使其成為所有三個平台中最低的免費層。

其他CI/CD平台

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "commonjs",
    "outDir": "./build",
    "rootDir": "./src",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true
  },
  "exclude": ["node_modules", "build", "**/*.test.ts"]
}

>由於我們在公共Github容器註冊表中發布了Docker映像，因此我們可以在支持Docker Images的任何平台上運行此圖像。這是由：

支持的

circle ci（docs）

travis ci（docs）

• >讓我知道如果您在其他地方運行，我對您的用例感到好奇！
>

---

？你能做什麼？

>我們在任何CI平台上為您的Web和移動應用程序運行自動lingo.DEV本地化。在每個提交中，它都使用lingo.dev本地化引擎更新整個存儲庫中的翻譯 - 作為新提交或通過打開拉請請求（DOCS）。

github的示例：

console.log("Hello World");

---

>無論您使用的代碼託管平台如何，您都可以構建可重複使用的操作，並輕鬆地將它們集成到工作流程中。以下是給您的一些想法：

>跨平台測試記者（編排端到端測試會話）
自定義代碼質量檢查器（考慮格式，覆蓋，測試）
• >
>發行說明生成器（在您的網站上發布更改式？）
• >

您將使用什麼？

>

？ 獎勵：模板存儲庫

>如果您不想閱讀文章的其餘部分，則可以在此處找到帶有所有代碼的模板入門存儲庫。它包含動作 - 您可以在github，gitlab和bitbucket上運行它。

>

https://github.com/mathio/awesome-actory-starter

？提示：克隆回購，使其成為您自己動作的起點：

…或者只是從我的模板中創建一個新的存儲庫。

name: Hello World
on:
  push:
    branches:
      - main

jobs:
  hello:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: "20"
      - name: Say Hello
        run: node index.js

然後，只需在src/index.ts文件中實現自己的操作邏輯。

結論

>我們已經看到瞭如何從簡單的基於殼的github動作發展到可以在任何地方運行的複雜的打字稿動作。關鍵要點是：

啟動Simple從Shell命令開始，以驗證您的自動化邏輯

dockerize您的操作以使其可移植

1. >使用容器註冊表在平台上分發您的操作
2. >在保持docker中的核心邏輯時，調整每個平台的配置
3. 這種方法使您可以靈活地在維護單個代碼庫的同時，在任何地方運行自動化。快樂自動化！
>我偶爾在Twitter上發布有關技術內容和新的lingo.dev功能的信息 @Mathio28。讓我們保持聯繫。

>

以上是與Docker建造跨平台CI/CD動作的詳細內容。更多資訊請關注PHP中文網其他相關文章！