oharu tech blog

文章

  • 我用 Terraform 接管了在 AWS 主控台手動建立的 AWS production 環境 — 保留各項 AWS 資源的名稱,並在 CI 擋下 Terraform 可能意外導致的刪除

    我參與開發的一個 AWS 資料層分成測試帳戶和 production 環境,其中測試帳戶是用 Terraform 建立的。建立時使用的模組,是我以唯讀方式擷取 production 的設定之後寫成的。詳細的做法寫在我之前寫的 Terraform 重建文章裡。那篇文章也提到,之後要讓 production 也使用同一個模組時,「只需要新增一個 tfvars 檔案」。 但 production 本身仍然是在主控台手動建立、手動修改的。我希望 production 也由同一個模組定義,並且由我手動啟動套用。但是當我第一次對 production 執行唯讀的 terraform plan 時,plan 竟然列出有 7 個資源要被刪除,這是因為主控台給這些資源取的名稱和模組產生的名稱不同。 現在,在 production 套用 Terraform 時會匯入既有的資源,並保留各項 AWS 資源原本的名稱。兩個帳戶都改由 Terraform 管理,合併到 main 時會部署到測試環境;只有透過手動啟動的 workflow 才會部署到 production,而且這個 workflow…

    閱讀更多
  • 我把同一個 MCP 伺服器映像部署成兩個 Bedrock AgentCore Runtime — 其他 AWS 帳戶用 SigV4,使用者用 Entra ID 認證

    我在 Amazon Bedrock AgentCore Runtime 上運行了一個 MCP 伺服器。第一個使用這個伺服器的 AI 代理,位在另一個 AWS 帳戶。那個 AI 代理的 ECS 任務嘗試連線時,既連不到簽發 token 的 Amazon Cognito 網域,也連不到 AgentCore 的端點。原因很可能是一個依目的地封鎖流量的對外連線過濾器。 在對外連線過濾器裡加上兩個主機,確實能讓這個 AI 代理通過,但其他呼叫端還是會遇到同樣的問題。Cognito 的 token 端點是公開的 Web 網域,沒有 PrivateLink,所以每次取得 token 的請求都會離開呼叫端的 VPC。 我把原本以 Cognito JWT 認證的 Runtime 改成了 IAM SigV4 認證,並用同一個映像另外部署了一個以 Entra ID 認證的 Runtime。這樣一來,其他 AWS 帳戶只要呼叫 IAM 版 Runtime 的 AWS 主機名稱即可。流量也能透過自己帳戶裡的 VPC endpoint,不必經過網際網路。需要在使用者認證後委任執行的工具,則放在 Entra ID…

    閱讀更多
  • 我用 Amazon Q Developer 把 SNS 警報送進 Slack — 只發布一則 SNS 訊息,依訂閱協定送出不同的內容

    我在 AWS 上運行一個文件翻譯工作流,目前每一則警報是以 SNS 電子郵件寄來,但我打算同時讓它將錯誤警報也送到團隊的 Slack 頻道上。 Amazon Q Developer in chat applications(前身為 AWS Chatbot)不必寫程式就能把 SNS 主題接到 Slack 上。所以在導入 production 環境之前,我先在自己的工作區試了一次。 CloudWatch 警示順利送到了 Slack,但我自己的程式發布的訊息全都被默默丟棄了。這是因為 Amazon Q Developer 只接受它自訂的通知 JSON。 解決方法是發布時加上 MessageStructure=json,只發布一則 SNS 訊息,就能讓電子郵件收到純文字的內容,讓 Slack 收到自訂通知的 JSON。 每個警報來源依然只呼叫一次 Publish,CloudWatch 警示送到 Slack 的方式也完全不受影響。

    閱讀更多
  • 我讓工作流在 Box 檔案上留言 @提及上傳者,並回報處理進度 — 開始、完成與失敗

    我做了一個工作流,每當有人把檔案上傳到 Box 資料夾時就會被啟動並處理該檔案。但每次我把檔案放進去時,都看不出它有沒有在處理。無論成功或失敗,上傳者都收不到通知,只能過一段時間再回來確認檔案是否處理好了。 我希望工作流能夠即時回饋處理狀況,讓上傳者了解自己的檔案處理到哪裡,但我不想另外建立 UI,也不想在 Slack 上通知,因為使用者一多,通知的數量也會跟著膨脹。 我的解決方法是在上傳的檔案上留言,並 @提及上傳者。留言的時機是開始處理時、處理完成並附上結果連結時,以及最終確定失敗時。Box 會用電子郵件和收件匣通知被提及的人,所以等待中的上傳者不必打開 Box,也能收到進度。

    閱讀更多
  • 我用純 CSS 讓 Astro 部落格的按鈕在滑鼠移入時浮起、掃過一道光,留下玻璃擬態裡我喜歡的效果

    我很喜歡玻璃擬態(glassmorphism)風格的元件。我在其他網站上常看到這樣的卡片:滑鼠移上去時會微微浮起,表面有一道光掃過,邊緣也會亮起來。我也想讓這個部落格的按鈕和膠囊標籤有同樣的感覺。 我最先擔心的是,這個效果會不會需要在瀏覽器裡執行 JavaScript,因為這個部落格的每一頁都是事先建置好的靜態 HTML。答案是不需要。整個效果都是瀏覽器在繪製時套用的 CSS,所以頁面依然和之前一樣是純靜態的。 實際做下來的過程中我發現,我喜歡的那些特徵其實都不是玻璃質感本身,而是浮起、掃光、強調色邊框和光暈等效果。玻璃的模糊效果需要在有背景的情況下才看得出來,但是這個部落格是素色背景,所以最後並沒有採用。現在浮起、掃光、強調色邊框和光暈都寫在同一個共用 class 裡,套用在網站的按鈕、膠囊標籤和可放大的圖表上。

    閱讀更多
  • Pagefind 搜尋在嚴格的 CSP 底下卡住了 — worker 只看載入它當次回應上的 header,而 304 不會帶上 CSP

    我在自己的部落格搜尋「claude」,搜尋框一直停在 「Searching for claude…」,沒有結果,也沒有錯誤。從兩個月前我為網站加上 Content-Security-Policy(CSP)之後就一直是這樣。這段期間,每個試著搜尋的讀者看到的都是同一個空白的搜尋框。 CSP 的 script-src 裡沒有 'wasm-unsafe-eval',所以瀏覽器拒絕編譯 Pagefind 在 worker 裡執行的 WebAssembly。編譯失敗的錯誤只出現在 DevTools 的主控台,搜尋則一直等不到結果。 加上 'wasm-unsafe-eval' 之後,只有新的訪客能夠正常使用搜尋功能。舊的訪客如果用的是已經快取了 worker 的瀏覽器,搜尋還是會卡住。這是因為瀏覽器會向 Vercel 確認快取的 worker 是否仍是最新的,而 Vercel 回覆「檔案沒有變更」的 304 回應裡沒有附上 CSP header。瀏覽器因此繼續使用快取裡的舊政策。 現在我把政策的雜湊寫進了 worker 檔案,所以只要政策一改,每個瀏覽器在下一次載入時都會拿到新的政策。

    閱讀更多
  • 我在 Astro 行內程式碼的色碼旁加上了色塊 — 為什麼選 rehype 外掛而不是 Swatch 元件?

    我在重讀我之前寫的 logo 文章時,看到其中一段主張網站強調色 #1d4ed8 和印章顏色 #d8452a 互相衝突。我這才發現,這段文字要讀者比較兩個根本看不到的顏色。VS Code 處理 CSS 等檔案時也會遇到同一個問題,它的做法是在每個十六進位色碼前面畫一個該顏色的小方塊。 我用 rehype 外掛在這個部落格上實現了同樣的效果。現在所有既有文章在三種語言版本裡的色碼前面都有了色塊,讓讀者一眼就能看出色碼代表的顏色。

    閱讀更多
載入更多