案例說明

最近串接 Stripe ，一個相當方便的國際化金流服務，
情境是主子帳號的綁定，
Stripe 可以透過 Oauth 的方式綁定不同的 Stripe 帳戶，
對於電子商務的平台來說，相當的方便，
它可以透過簡單的授權機制，取得客戶的金流資訊，

這時候問題來了，營運部門發現有的時候客戶會不小心將授權解除，
這會導致帳務上的問題，所以需要在第一時間被通知，
而 Stripe 其實也有提供 Event Driven 的解決方案。

透過 Webhook 監聽指定的事件 (Event)，可以串接各種通知服務。
ex: Line、E-mail、簡訊甚至是電話，
開發這樣的通知服務並不難但是要時間的。

而其中最大的風險在於 Event 送到 Webhook 再到通知服務的這段流程。
如果這段不通，就算 Event 確實會發生，就算通知務服務是正常的，
仍然會收不到通知。

有沒有辦法快速驗証 Webhook 呢?
有沒有辦法快速驗証 Webhook 呢?
有沒有辦法快速驗証 Webhook 呢?

網路上的 Solution

這個時候就要推薦一下網路上的這個服務 Request Bin
登入後只需要一鍵，就可以快速建立一個 EndPoint
而且立即生效，有任 Request 進來都會完整記錄。

好處

1. 快速建立 EndPoint
2. 立即生效
3. 免費

如果有其它類似的服務，請推薦。

參考

• https://stripe.com/docs/webhooks
• https://stripe.com/docs/api/issuing/authorizations
• https://requestbin.com/

(fin)

前情提要

我通常會作一些 Code Snippet 來加速開發，
避免同樣的代碼要重複的寫，
除了避免重複，能交給工具的儘量交給工具去作，
只要是人為的操作就有可能犯錯，就算是簡單的剪下貼上，
讓工具作事，用心去檢驗，這是我在 2019 練習的小心得。

比如說我使用無蝦米輸入法、刻意練習英打速度，
購買 Reshaper 等…，都是為了提昇生產力。
今天就是要說說 Reshaper 的 Template ，
這是一個跟 Code Snippet 相同的功能 。

本文

Template 與 Code Snippet 並不使用共同的範例檔，
所以要如何將已有的 Snippet 轉移過來呢 ? 如果有人知道請跟我說。
另一個問題是，他真的比原本的 Snippet 好用嗎 ?

因為我的 Snippet 並不多，大約 10 個左右
為了馬上增加生產力，我手動將主要有用到的 2 個重建了
剩下的如果真的很少用，就讓他自然淘汰吧。
常用的如果有用到再來重建。

第二件事，我使用上手感是差不多的
據說 Resharper 會更智慧化，所以我會選用 Code Template

如何新增

以 Visual Studio 2019 與 Resharper Ultimate 為例，
在搜尋框輸入 Template 找到 Template Explorer
點擊新增圖示，進行編輯，
其它就跟原本的 Snippet 差不多，也可以提供參數化入與 short cut

補充

如果已經安裝了 Resharper Ultimate 但是 Template 不工作的話記得看一下設定

Resharper > Option > Intellisense > General

參考

• https://blog.darkthread.net/blog/vs-code-snippet-with-resharper/
• https://www.jetbrains.com/help/resharper/Creating_a_File_Template.html

(fin)

ACID 與 Isolation Level

什麼是 ACID

• Atomicity（原子性）：
  一個交易（transaction）中的所有操作，要嘛全部完成，要嘛全部不完成，
  不會在中間某個環節中斷。交易在執行過程中發生錯誤，會被回滾（Rollback）到交易開始前的狀態，
  就像這個交易從來沒有執行過一樣。即，交易不可分割、不可約簡。
• Consistency（一致性）：
  在交易開始之前和交易結束以後，資料庫的完整性沒有被破壞。
  這表示寫入的資料必須完全符合所有的預設約束、觸發器、級聯回滾等。
• Isolation（隔離性）：
  資料庫允許多個並發交易同時對其數據進行讀寫和修改的能力，
  隔離性可以防止多個交易並發執行時由於交叉執行而導致數據的不一致。
  交易隔離分為不同級別，
  包括未提交讀（Read uncommitted）、
  提交讀（read committed）、
  可重複讀（repeatable read）和串行化（Serializable）。
• Durability（持久性）：
  交易處理結束後，對數據的修改就是永久的，即便系統故障也不會丟失。

問題，欄位 price 現在為 100，兩筆交易同時發生，A 交易為 price+10, B 交易為 price-15 請問最終的值為何

MsSQL 預設的 Isolation Level 為 READ COMMITTED

情境題 & SQL

建立測試資料

1
2
3
4
5
6
7
8
9
10
11
12
13

CREATE TABLE [dbo].[ACIDSample](
    [ACIDSample_Id] [bigint] IDENTITY(1,1) NOT NULL,
    [ACIDSample_Name] [nvarchar](100) NULL,
    [ACIDSample_Price] [Decimal] NULL)

INSERT INTO [dbo].[ACIDSample]
           ([ACIDSample_Name]
           ,[ACIDSample_Price])
     VALUES
        ('Toy',150),
        ('Shoes', 120)

GO

Read Committed(MsSQL 預設值) vs Read Uncommitted

差別在於會不會讀到髒資料，
Read Uncommitted 不會使用 locked 來避免未 commit 的資料被讀取，
參考以下範例:

假設目前 ACIDSample_Price = 100

Sample READ COMMITTED

Session 1，執行 Update 後延遲 10 秒後 Rollback

1
2
3
4
5
6
7

BEGIN TRANSACTION
UPDATE ACIDSample
SET ACIDSample_Price = ACIDSample_Price + 10
WHERE ACIDSample_Id = 1

WaitFor Delay '00:00:10'
Rollback Transaction

Session 2，
設定 TRANSACTION ISOLATION LEVEL 為 READ COMMITTED，
目前 ACIDSample_Price = 100
執行查詢，在 READ COMMITTED 的情境況下，會等待延遲結束後取得資料

1
2
3

-- SET TRANSACTION ISOLATION LEVEL
SET TRANSACTION ISOLATION LEVEL READ COMMITTED
SELECT ACIDSample_Price FROM ACIDSample WHERE ACIDSample_ID = 1

Sample READ UNCOMMITTED

Session 1，與前一個範例相同，執行 Update 後延遲 10 秒後 Rollback

1
2
3
4
5
6
7

BEGIN TRANSACTION
UPDATE ACIDSample
SET ACIDSample_Price = ACIDSample_Price + 10
WHERE ACIDSample_Id = 1

WaitFor Delay '00:00:10'
Rollback Transaction

Session 2，執行查詢，在 READ UNCOMMITTED 的情境況下，
會立即取得未 Commit 的資料(Dirty Data)，不需要等待 10 秒

1
2
3

-- SET TRANSACTION ISOLATION LEVEL
SET TRANSACTION ISOLATION LEVEL READ UNCOMMITTED
SELECT ACIDSample_Price FROM ACIDSample WHERE ACIDSample_ID = 1

Sample Repeatable Read

Session 1
設定 TRANSACTION ISOLATION LEVEL 為 Repeatable Read
執行以下 SQL 後，立即執行 Session 2 的 SQL，
等待 10 秒(Delay)後執行 Session 3 的 SQL

1
2
3
4
5
6
7
8
9

SET TRANSACTION ISOLATION LEVEL REPEATABLE READ
BEGIN TRANSACTION
SELECT * FROM ACIDSample

WaitFor Delay '00:00:10'
SELECT * FROM ACIDSample
WaitFor Delay '00:00:10'
SELECT * FROM ACIDSample
COMMIT Transaction

Session 2 新增一筆資料

1
2

INSERT INTO ACIDSample (ACIDSample_Name,ACIDSample_Price)
VALUES ('Cat',200)

Session 3 刪除一列資料

1

DELETE ACIDSample WHERE ACIDSample_Name = 'Cat'

等待 Delay 結束後，可以看到查詢結果如下
第 2 次的查詢會與第 3 次一致，但是實際上的資料已經被刪除了

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

ACIDSample_Id        ACIDSample_Name                                                                                      ACIDSample_Price
-------------------- ---------------------------------------------------------------------------------------------------- ---------------------------------------
1                    Toy                                                                                                  132
2                    Shoes                                                                                                120

(2 rows affected)

ACIDSample_Id        ACIDSample_Name                                                                                      ACIDSample_Price
-------------------- ---------------------------------------------------------------------------------------------------- ---------------------------------------
1                    Toy                                                                                                  132
2                    Shoes                                                                                                120
7                    Cat                                                                                                  200

(3 rows affected)

ACIDSample_Id        ACIDSample_Name                                                                                      ACIDSample_Price
-------------------- ---------------------------------------------------------------------------------------------------- ---------------------------------------
1                    Toy                                                                                                  132
2                    Shoes                                                                                                120
7                    Cat                                                                                                  200

(3 rows affected)

試著把 Session 的 ISOLATION LEVEL 調成 READ COMMITTED

Session 1 (READ COMMITTED)

1
2
3
4
5
6
7
8
9

SET TRANSACTION ISOLATION LEVEL READ COMMITTED
BEGIN TRANSACTION
SELECT * FROM ACIDSample

WaitFor Delay '00:00:10'
SELECT * FROM ACIDSample
WaitFor Delay '00:00:10'
SELECT * FROM ACIDSample
COMMIT Transaction

結果在同一筆交易內會相同的會查詢到不同的結果

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

ACIDSample_Id        ACIDSample_Name                                                                                      ACIDSample_Price
-------------------- ---------------------------------------------------------------------------------------------------- ---------------------------------------
1                    Toy                                                                                                  132
2                    Shoes                                                                                                120

(2 rows affected)

ACIDSample_Id        ACIDSample_Name                                                                                      ACIDSample_Price
-------------------- ---------------------------------------------------------------------------------------------------- ---------------------------------------
1                    Toy                                                                                                  132
2                    Shoes                                                                                                120
9                    Cat                                                                                                  200

(3 rows affected)

ACIDSample_Id        ACIDSample_Name                                                                                      ACIDSample_Price
-------------------- ---------------------------------------------------------------------------------------------------- ---------------------------------------
1                    Toy                                                                                                  132
2                    Shoes                                                                                                120

(2 rows affected)

Serializable

上面的範例，雖然確保了查詢的一致性，但實際上會查詢到不存在的資料(Phantom)，
為了避免這樣的情況可以考慮使用 Serializable，但實際上會帶來效能的耗損，
在這樣嚴格的限制下，所有查詢將有序的執行。

Session 1

1
2
3
4
5
6
7
8
9

SET TRANSACTION ISOLATION LEVEL Serializable
BEGIN TRANSACTION
SELECT * FROM ACIDSample

WaitFor Delay '00:00:10'
SELECT * FROM ACIDSample
WaitFor Delay '00:00:10'
SELECT * FROM ACIDSample
COMMIT Transaction

也就是說在執行了 Sesson 1 的 SQL 之後 ，
Sesson 2 即使在 Delay 的時間中執行也必須等待 Sesson 1 結束才會執行，
這樣確保了資料一致性同時也不會拿到 Dirty Data 或 Phantom

Session 2 新增一筆資料

1
2

INSERT INTO ACIDSample (ACIDSample_Name,ACIDSample_Price)
VALUES ('Cat',200)

Session 3 刪除一列資料

1

DELETE ACIDSample WHERE ACIDSample_Name = 'Cat'

SARGs (Search Arguments)

SQL 效能調校的一些 GuideLine

建議使符合「查詢參數(Search ARGument SARGs)」規則

• SARGs 的格式：

  • 「資料欄位 部份運算子 <常數或變數>
  • 常數或變數> 部份運算子 資料欄位」
  • 運算子：=、<、>、>=、<=、BETWEEN、LIKE ‘關鍵字%’

• 非 SARGs 格式：

  • 對資料欄位做運算
  • 負向查詢：NOT、!=、<>、!>、!<、NOT EXISTS、NOT IN、NOT LIKE
  • 對資料欄位使用函數
  • 使用 OR 運算子

參考

• https://medium.com/getamis/database-transaction-isolation-a1e448a7736e
• http://vito-note.blogspot.com/2013/05/blog-post_1930.html
• https://dotblogs.com.tw/ricochen/2011/07/31/32374
• https://www.sqlservercentral.com/articles/isolation-levels-in-sql-server
• https://medium.com/@chester.yw.chu/%E5%B0%8D%E6%96%BC-mysql-repeatable-read-isolation-%E5%B8%B8%E8%A6%8B%E7%9A%84%E4%B8%89%E5%80%8B%E8%AA%A4%E8%A7%A3-7a9afbac65af
• https://www.youtube.com/watch?v=7nv-7XQI7p0
• https://www.youtube.com/watch?v=ZtPj09tJjnQ

(fin)

前言

在 N 社 4 年了，一直以來都有一個習慣，就是每年都會定期開 CV，
有好的機會就去面試看看。
部門主管 C 哥在這部份相當開明。
我印象深刻是剛進公司時，他要大家寫 1 年後的履歷寄信給他再跟他 1-1。
他也鼓勵有好的機會就去試，重點是「以終為始」，搞清楚自已要的到底是什麼 ?

理由

有比沒有好一點的敏捷

我是一個理論的實踐者，如果有我認同的理想，
就會試著去實踐，可惜「理想很豐滿，現實很骨感」，
理論與實踐往往總是有一條橫溝。
這不是我想走的主因，但是如果我能找到橫溝一處較窄的地方。
我想我會毫不猶豫的走過去。

打不敗的通膨

另一個理由就更現實了，「薪資」基本上 4 年來是沒有調整的，
當然我的計算方式比較特別。我是會考慮通膨率，
此外，在這個大前端的時代不知道為什麼我好像選錯了邊，
不得不說 F2E 的價金較高機會也較多。
而我在 C 社時期，其實是前後通吃的，但是不包含切版。
在 N 社我不止一次想轉換到 F2E 卻有以下幾個卡點，

1. 缺乏實際行動，僅止於與 F2E 主管聊聊的階段
2. 切版在 N 社 F2E 是必備技能，但不是我職涯規劃中準備投資的項目
3. 過舊的技術棧 Angular 1.0 與 KnockOutjS 還有 KendoUI 等…
4. F2E 與 RD 部門的 Silo

重點我想還是在 1 ，其它項目其實都有漸漸在改變。

工作內容

再延申到最後一個原因，想作的事與正在作的事。
其實我很清楚，這兩者要相同並沒有那邊容易，
想作的事還很模糊，而正在作的事很無聊。
過去一年基本上只是在抽字串，
或是將功能搬到 A 市場, 再搬到 B 市場，
而且真的只有搬，有沒有人用都不知道，業績如何也不知道，團隊作起來很沒有成就感。

而跟主系統(台灣市場)比較起來，A/B 市場規模相對小，人力也少，
當有產品需求調整的情況，往往犧牲的都是 A/B 市場的，再由我們開發補丁作修正。
而不是一開始就以一個國際化的產品在設計產品，這樣作下來漸漸就提不勁了。

就業一段時間應該都知道，只有功勞沒有苦勞。
不賺錢，沒資源，更不賺錢，更沒資源是一種惡向循環。

我的解決方案，重新定位團隊目標，
所以我非常強力推動幾個項目的國際版標準化，
因為我認為這才是我們的核心項目。

彼得效應

彼得效應其實是我在 C 社的功課，簡單的說就是碰到天花板了。
不論在能力上、薪資上或是發展性上都到了一個瓶頸，
這問題不只在我身上，在我的同儕、我的主管以及我周邊所有的人身上，
我以前會考慮，要如何才能延續我技術人員的生涯?
特別是在這個變化如此快速的時代。

目前我還沒有一個很完整的答案，不過我周邊的人離開了原本公司之後，
又遇到了相同的問題，討厭的主管/討厭的政治環境/討厭的工作內容，
在不同的公司，卻有相同離開的理由…
我目前的想法，不再只以「技術人員」作考量，
在薪資可接受的範圍下，我作為一個人，作為「我自已」我要如何讓自已盡可能的發展 ?
純技術是不是自我設限 ? 主管不會領導，那我能不能反過來引導他 ?
環境不喜歡，我能不能改變它 ? 人不喜歡，我能不能找到志同道合的夥伴 ?

身體因素，眼花花心慌慌

去年 5 月身體微恙，其實自已有點被嚇到，
劇烈的頭痛外加短暫的視力消失，
N 社一直以來都有鼓勵用下班時間進行一些工作的文化，
包含午休時間的「分享」或讀書會，對我來說沒有不好，
但是貪多不得，反而傷害了身體，
這次病後，比較會注意自已的飲食與作習，
畢竟留得青山在不怕沒柴燒。

面試記錄

講了一堆現在才要進到主題。
先講結論，我愛的人不愛我，愛我的人我不愛。

Nxxx Bxxx

純網銀的公司。慕名 N 社前 HR 大主管之名而去，
面試機會好像很難拿到，但是我運氣蠻好的，拿到了面試機會。

總共有三面，
第一面是技術職的面試(60mins)，只有閒聊工作上的經驗，沒考什麼技術。
有三個技術主管，聊起來的感覺人都蠻和善的。
技術棧並不確定，但是有很多機會，什麼都可以嘗試的感覺。
不太熟悉敏捷，但是宣稱一定會跑測試與自動化等功能。

第二面是 N 社的前主管(30mins)，合作的機會不多，所以互相聊了一下公司的進況。
另外我問了一些新聞八掛(肥貓啊、排名最後啊…)，也很坦率的回應，
他敢說我就敢信，基本上沒有逃避閃躲問題我覺得就 Ok 了

第三面是總經理，基本上不問你問題，
而是請你問問題，但是我覺得我沒有準備的很好，
只有問一下目前的目標與挑戰，回答是「活下去」

Offer : Get

Txxxx

社群上有名的「敏捷」公司，遊戲產業，
剛好有認識的人介紹之下去面試。

面試的內容，程式題一題，DB 題一題，
不過相當的簡單，不太像是在找 Senior 的題目，
剩下的就是閒聊，不過可能是我聊的沒有很好，另外一個可能性，就是薪資的問題所以沒有上。

感覺比較差的兩點，
一個是 T 社找了我兩次，
兩次 HR 都說不論是否錄取都會通知，
但是兩次都沒有通知，
第二次去面試前我還有特別在通訊軟體上與 HR 確認是否會告知結果，
但是仍然是無聲卡。

第二點是兩次面試的題目一模一樣，
完全沒有變化，面試官也知道但好像也不是很介意，
但是以我面試者的角度會覺得這間公司在招慕上沒有什麼鑑別度。

Offer : 無聲卡 * 2

Cxxxxxxxx

主要作工程師媒合平台，是我非常喜歡的一間公司，
也是第一次線上面試，問題蠻廣泛的，但是我覺得我都回答得出來
只有問了一題 ACID 我沒有回答的很好，我有另文記錄。
總之就是我對 DB 的認識停留在預設值，而沒有考慮應該商業需求可能的調整。

另外我作了一些線上面試的小小 Retro，稍稍記錄一下

• 面向光源，不然你會臉會很黑
• 保持背景單調乾淨
• 跟同居的事先說好有面試，避免臨時打擾
• 儘可能讓攝影機高過你的頭，不然看起來會很肥
• 就算是凌晨面試也要梳洗，看起來比較有精神
• 網路可能有延遲，可以稍等一下再回答問題

Offer : Reject

Fxxxxxxxxx

後面好像有個富爸爸的收據公司，數位轉型作 CMS，
而且只針對 mobile 製作，聽起來工作內容蠻輕鬆的。
不過他們的瓶頸在 DB ，所以要找一個後端懂 SQL 的人。
只有一面，介紹產品還有面臨的問題，
技術棧算蠻新的，不過沒有 CI/CD 與自動化等工程。

CMS 是我蠻喜歡的 Topic , N 社現在也有在作，
但是我最後還是拒絕了。

主要的原因可能是，我覺得技術上好像沒有辦法在那邊得到進步。

Offer : Get

Axxxxxx

微軟 Teams 服務的合作廠商，主要作數位電話相關。
也是朋友介紹的公司，應該是第二次找我，
因為之前沒有很強烈的離職意願，所以沒有去面試。
特色的早上班早下班，大概 5 點就能下班了，據說不太加班，
一面，與美國主管線上訪談，這次有吃到 Cxxxxxxxx 的經驗，
所以聊得蠻順利的，美國主管有技術底，會講中文所以溝通無礙，
不過我一直以為他是美國人，其實是台灣人的樣子，只是在美國待久了有點口音。

二面，跟台灣當地主管面試，介紹產品與閒聊，
老實說工作環境與地點還有薪資我都蠻 OK 的，
當初有考慮過接收 Offer 的。
最後就是跟朋友閒聊，朋友是 C 社的前同事。
基本上就是一個小公司，產業蠻穩定的，那個職位也有很多機會，
但是成長就要靠自已了，現在想想還是會覺得放棄可惜。

Offer : Get

小結

我覺得定期作面試是很有幫助的，
他能帶來以下的好處，

• 了解市場需求，直接面對第一線的招幕才知道現在含金量最高的技術是什麼
• 了解自已，過程中不斷評估自已要的東西(薪資、成就感、穩定、福利、名氣…)，什麼都是假的，離開(或留下)才是真的
• 了解不足與市場的差距(特別是技術面)
• 與不同產業的技術主管聊天，技術只是一種手段，不要忘記背後的商業目的

家家有本難唸的經，不同的公司也有不同的難處，
時時檢視自已所處的環境，換或不換你都可以選擇，
成為更好的自已。
開始準備 2020 的履歷囉。

最後謝謝所以推薦我與面試我的人。

後記

我在 2020 年 3 月前往 A 社，擔任 Scrum Master。
階段性任務完成後，2021 年 10 月離開 A 社，11 月就職於 T 社。
2022 年 1 月 A 社相關的開發量能轉移到尼泊爾，台灣部門解散，
雖然老闆與前同事有邀約相關新的工作機會，但已任職於 T 社的情況下，
不想過度操勞自已的身體，並沒有兼任相關職務。

20210322 更新

關於 N 社的新聞與社評幾則。

(fin)

學習 Swing 大概滿周年了，最初的理由已經有點忘記了;
為了避免忘掉更多東西，還是隨手記錄一下自已的一些小小想法。

波動的感覺

在新手期的階段有一件有趣的事，在牽起 Follower 手的時候，
大概就知道這個人有沒有跳過舞，基本上會有波動從對方的手傳遞過來，
正常來說這個波動應該是上下的，有時候會遇到左右或是扭扭的波動，
也有波平如鏡的狀況。

Lindy 的基本動作之一是 Bounce，它帶來的波動應該是上下，而且是下律動的。
所以如果感覺到不太一樣的波，大概可以猜這個人之前有跳過別的舞蹈，
準確率還蠻高的，只是現在我好像感覺不太到了。

與武術的關係

上面提到了波，就聊聊舞與武的關係，因為不知道為何我腦海總會出現「波動拳」三個字。
除了波以外，練基本步跟 Bounce 就好像是在蹲馬步，跟 Follower 練習就好像在練套路(Kata)
而 Social 場合就像是賽際過招，年度大型 Event 就是天下武術大會的概念。

目的

跳舞的目的很抽象，不像其它的運動，有明確的目的，例如把球投進籃子裡或是率先衝過終點線。
我給自已訂了一些目標與原則，
首先要讓 Follower 感到安全，
同時不能讓他感到無聊，整個過程必須是有趣的，
最後一定要讓 Follower 跳得好看。
如果 Follower 被誇獎跳得很美，Leader 才算成功。

規則

一開始學習給的一些自我約束，不一一說明原委，反正我就是喜歡沒事找事作

1. 不要找同一個人一直跳舞，儘可能每首都換
2. 全場通殺，小一點的 Social 場合儘量跟每個人都跳到
3. Follower 永遠是對的，如果 Follower 跟錯了，想想是不是自已的 Leading 不夠明確
4. Last Song , 可以的話最後一首一定要跳

教室

Big Apple(BA)、Swing Taiwan(ST)、YM Swing(YM)、Lindy Island(艾倫)、JF Swing(JF)、Naughty Swing

台北我知道的教室大概就這幾間(2019)，第一次是在 ST 上的，後來時間對不上就去 YM 學了一陣子(半年以上)，
Lindy Island 上過一期 Swing Out(四堂)，Naughty Swing 上過一次 Solo 。
上面的教室括號內是教室的簡稱，然後我是按照某種神祕規則排序的，不知道有人看得出來嗎 ?

給一年前的我的建議

1. 不要先學 Charleston 。
2. 照教室開課的順序去學，但是覺得困難的話，與其往下上，不如上複習班
3. 不同教室類似的課通常會錯開，時間金錢許可的話都去上。
4. 常去 Social 多聽音樂，練習、練習、練習
5. Solo 比想像中的好玩，一定要試試
6. Keep Learning

(fin)

目標

使用 GitHub Package Registry 建立一個自已的 Nuget Server。

步驟

前置作業

申請

GitHub Package Registry 還在 Beta 階段，需要申請才能取得試用。
過程並不複雜，在此不贅述，請再自行查找網路。

建立 Repository

實測的結果，nuget push 並無法建立 Repository ，
並且會導致發佈失敗，故必需 優先建立 Packages 的 Repository 。
Repository 可以包含多個專案，並獨立發佈(發佈指令詳見下文)。

建立 .nuget 文檔

請以專案名稱命名檔案，ex:Marsen.Utility.nuget
請依實際情況調整 id、version 與 projectUrl
特別是 version 代表的是 Packages 的版本
更多訊息請參考

1
2
3
4
5
6
7
8
9
10
11

<?xml version="1.0" encoding="utf-8"?>
<package xmlns="http://schemas.microsoft.com/packaging/2010/07/nuspec.xsd">
    <metadata>
    <id>Marsen.Utility</id>
    <version>1.0.0</version>
    <authors>Marsen Lin</authors>
    <description>Marsen Utility</description>
    <language>en-US</language>
    <projectUrl>https://github.com/marsen/Marsen.Nuget.Packages</projectUrl>
    </metadata>
</package>

取得授權 token

請參考 Configuring NuGet for use with GitHub Package Registry 或是 Creating a personal access token for the command line
至少需要以下權限

• repo Full control of private repositories
  • repo:status Access commit status
  • repo_deployment Access deployment status
  • public_repo Access public repositories
  • repo:invite Access repository invitations
• write:packages Upload packages to github package registry
• read:packages Download packages from github package registry

下載/安裝/設定 Nuget

1. 下載 Latest Nuget，取得 nuget.exe
2. 設定 Path (以 Windows 10 為例)
   • 控制台
   • 系統設定>進階設定
   • 環境變數 > Path
3. 設定完 path 記得重啟 Terminal Session

新增 Nuget Source

新增

Name 、 Source 與 UserName 網址請依實際調整參數
Password 請代入 token

1
2
3

nuget sources Add -Name "Marsen.Nuget sources" /
-Source "https://nuget.pkg.github.com/marsen/index.json" /
-UserName marsen -Password 3*******************************1

設定 Key

1

nuget setapikey 3*******************************1 -Source "Marsen Nuget Sources"

刪除

1

nuget sources Remove -Name "Marsen.Nuget sources"

查詢

1

nuget sources

打包

1

nuget pack Marsen.Package.csproj -OutputDirectory c:\local_nugets

發佈

1

nuget push c:\local_nugets\Marsen.Utility.1.0.0.nupkg -Source "Marsen Nuget Sources"

結果

下一步

1. 每次都要打版號好麻煩，能不能自動化 ?
2. 透過 CI 建立，並傳入參數作為版號 ?
3. 每次 commit 只要通過 UT 測試就發佈.beta 版 ? CI 發佈正式版 ?

more…

參考

• Configuring NuGet for use with GitHub Package Registry
• Creating a personal access token for the command line
• https://www.nuget.org/
• https://docs.microsoft.com/zh-tw/nuget/install-nuget-client-tools
• https://docs.microsoft.com/zh-tw/nuget/reference/nuspec

(fin)

輸入法

• 無蝦米 (加速打字，未來不太看好，考慮更換中…)

網站

• Slant 工具比較
• 開發常用的工具網站 JSON/YAML/SQL
• 亂數假文產生器 - 中文
• 亂數假文產生器 - 英文
• 資訊收集/廢文發佈

PC 工具

• 文字比較工具
  • Win Merge
• Git GUI
  • GitKraken(需收費)
  • Fork
• Carnac
  • 顯示鍵盤點擊歷程
• Windows 用 Launchers
  • Wox
• 快速搜尋文件
  • Agent Ransack
• 跨 PC 存放檔案
  • Dropbox
• 截圖錄影工具
  • ShareX
  • Skitch
• 遠端桌面管理
  • Remote Desktop Manager Free (試用中)
  • Remote Desktop Connection Manager
• windows 仿 linux 指令
  • cygwin

筆記工具

• Evernote
  • 專案分類
  • 職涯規劃
  • 已完成的項目
• Notion
  • GTD
  • 周記劃
• HackMD
  • 暫存的記錄
  • 會議/社群活動即時記錄
  • Blog 草稿
  • 共筆
• Blog
  • 技術實作記錄
  • 社群活動記錄

瀏覽器 & 外掛

95% 使用 Chrome ，4% 使用 FireFox，極少情況使用其它瀏覽器

Chrome

• tampermonkey
  • 撰寫網頁小工具
• One Tab
  • 快速收攏大量分頁，常用在特殊主題搜尋的暫存
• Clear Cach
  • 清快取
• grammarly
  • 拼字校正
• Bitbucket Diff Tree
  • Bitbucket PR 差異比較
• JSONView
  • 當 response 為 json 時更為好讀
• LastPass: Free Password Manager
  • 密碼管理
• Wappalyzer
  • 分析網站使用的框架與技術
• cVim
  • 使用 Vim 的習慣操作網頁

文件編輯器

• Vim
• NotePad++
• 記事本

個人工具

• 桌面記時器 DesktopTimer.exe

開發工具

VS Code

• ejs
• C#
• Chinese (Traditional) Language Pack for Visual Studio Code
• Cucumber (Gherkin) Full Support
• Docker
• Git History
• Git Project Manager
• GitLens — Git supercharged
• JSON Tools
• Markdown All in One
• markdownlint
• Paste URL
• PowerShell
• Relative Line Numbers
• Remote - WSL
• REST Client
• Settings Sync
• Snippets and Syntax Highlight for Gherkin (Cucumber)
• Sort lines
• SQL Server (mssql)
• stylus
• Swagger Viewer
• Unique Lines
• Vim
• vscode-icons
• Vue 2 Snippets

Microsoft Visual Studio Professional 2017 (預計升到 2019)

• OzCode (付費軟體)
  • 增強除錯
• ReSharper Ultimate (付費軟體)
  • dotCover (檢驗覆蓋率，需另外安裝)
  • 強化重構/測試
• ILSpy
  • 反組譯工具
• SpecFlow for Visual Studio 2017
  • BDD 開發
• GhostDoc Community for VS2017 and Later (免費版)
  • 自動加入註解
• ResXManger
  • 多語系 Resource 檔編輯
• VsVim
  • Vim 支援工具
• Snippet Designer
  • Snippet 編輯管理
• Style Cop
  • 代碼審查
• xUnit.net.TestGenerator
  • 加速寫單元測試(xUnit)
• CodeMaid
  • 代碼審查 & 複雜度
• Visual F# Tools [實驗性]
• Roslyn Expression Evaluators [實驗性]
• Roslyn Interactive Componets [實驗性]
• Roslyn Language Service [實驗性]
• Microsoft Library Manager
• Develop Automated Tests VS2017
• Visual Commander
• Fix Mixed Tabs
• Microsoft Visual Studio 測試平台
• Microsoft Visual Studio Installer Projects
• Microsoft Azure WebJobs 工具
• Cloud Explorer for VS 2017

LINQPad 5 (付費)

快速檢驗 C# 語法的小工具

Terminal

• Cmder | Console Emulator
• Windows Powershell ISE

資料庫管理

• Redis Desktop Manager (Redis)
• SSMS (MsSQL)
• Robo 3T (Mongo DB)

容器管理

• Docker Desktop
• Kitematic

(fin)

要知道的事

這篇是實作的紀錄，大部份資源都參考至 MSDN 線上文件
那裡會有更新更完整的文件支援。

前情提要

專案上作了一個跨市場的服務，以提供主服務對不同市場金流的支援。
首先有一個國際化的專案，用來制定 API 層級的標準化，
而在不同的市場，例如:馬來西亞、香港、烏克蘭等…。
在地化的項目需要建立外掛(Plugin)專案的方式進行開發…

建立一個全新的 Plugin 專案是一件麻煩的事，
首先要加入專案，再來要實作相對應的介面，
這裡指的是建立一個類別，然後繼承一堆介面，
ex:IPay、IRefund、ICheck…等，
並不包含商務邏輯的開發與實際的 API 或 SDK 串接，
而在公司的標準之下，我還必須引入一堆參考或 Nuget 套件。
同時因為國際化專案採用動態載入的機制，
有一些細節準則需要由 Plugin 專案遵循，才不會引發異常或 Runtime Error。

記錄

建立專案樣版 SOP

1. 建立樣版資料夾，比如說 Blog.Plugin.Template

2. 準備好你的專案檔與相關的必要檔案

   這裡的檔案你可以拿現成專案作修改，我個人是從頭手工打造了一個全新的 Plugin。
   並且去除所有不相關不必要的資料夾、檔案、參考與程式。
   簡單的來說，這是一個殼、一個專案樣版(Template)而已。
   接下來會遇到的問題「參數化」，比如說專案的名稱，資料夾的名稱，或是程式本身的內容，會依據不同的 Plugin 專案而改變的部份。
   我把它分為檔案層級與內容層級的參數化。

   • 檔案層級參數化

     表示檔案名稱或是資料夾名稱等，我有動態抽換的需求。
     我會用 F-* 作為參數名稱，比如說 F-plugin-name
     接下來將資料夾或檔案名稱想被抽換的部份改成參數名稱就好，參考下圖。
     

   • 內容層級參數化

     比如說 Class Name、Namespace、建構子或方法，甚至是預設的註解，
     簡單的說只要是檔案內容相關的文字有必要被抽換，我就會使用這個參數設定。
     我會直接使用 C-* 參數名稱，比如說 C-plugin-name。
     下面是個例子。
     

3. 建立 .template.config 資料夾

4. 在.template.config 建立 template.json
template.json 可以說是整個專案樣版的靈魂部份，更多的訊息可以在 MSDN 找到，
   我只說明 symbols 節點的部份，它用來方置參數的訊息，所以需要建立一個自訂義的子節點，在這裡我命名為 pluginName，同時指定他的 type 為 parameter，
   透過設定 defaultValue 給予預設值，最後將 fileRename 指定為 F-plugin-name，
   將 (C-plugin-name) 指定為我的內容層級參數。

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21

   { "$schema": "http://json.schemastore.org/template", "author": "MarkLin", "classifications": [ "Common", "SDK", "C#8" ], "identity": "Marsen.Blog.Plugin.Template", "name": "Marsen Blog Plugin Template", "shortName": "mbp", "tags": { "language": "C#", "type": "project" }, "preferNameDirectory": true, "symbols":{ "pluginName": { "type": "parameter", "defaultValue": "Demo", "fileRename": "F-plugin-name", "replaces":"(C-plugin-name)" } } }

5. CLI 強化，在.template.config 建立 dotnetcli.host.json
   這個檔案建立的目的，是為了讓我接下來使用 CLI 建立專案時能夠指定傳入的參數。
   這裡需指定 template.json 中的 symbol 並設定

   1 2 3 4 5 6 7 8

   { "symbolInfo": { "pluginName": { "longName": "pluginName", "shortName": "p" } } }

6. 執行 dotnet new i 註冊樣版
   執行命令前請確定所在位置包含.template.config 資料夾與相關的檔案

   1	dotnet new -i ./

7. 執行 dotnet new -u 查詢樣版列表資訊確認安裝已完成

8. 應用

   在想建立專案的資料夾底下執行 dotnet new <template_name> 語法,
   並且可以透過 CLI 指定參數，我並沒有研究 GUI 的操作，有興趣的人請自行研究，
   如果能分享給我就不勝感激。

   1	dotnet new mbp -p Marsen2

9. 展示

我把這個例子放在 Github 上，有興趣的朋友可以試試看。

其它

移除專案樣板 SOP

1. 執行 dotnet new -u 查詢樣版列表資訊，可以查到專案樣版的絕對路徑
2. 執行 dotnet new -u <ABSOLUTE_FILE_SYSTEM_DIRECTORY>

更新專案樣版

直接進入專案樣版的絕對路徑

發佈

略…

參考

• 我的範例
• 教學課程：建立項目範本
• 教學課程：建立專案範本
• dotnet/dotnet-template-samples
• Tips for developing templates for dotnet new
• JSON 結構描述保存區的 template.json 結構描述
• How to name (or rename) files based on a parameter? · Issue #1238 · dotnet/templating
• Tips for developing templates for dotnet new

(fin)

前情提要

最近將一個服務掛上雲端(AWS)，使用 EC2 ，
並且實作了 Auto Scaling ，特別紀錄一下。

概觀

以下使用的都是 AWS 的服務

1. Auto Scaling Group (ASG) :
   本篇主角，根據指定的 Policies 與 LC 加開減少機器。

2. Launch Configuration (LC) :
   一個 ASG 背後一定要搭配一個 LC，可以說是 ASG 的生命共同體，
   用來指定 EC2 的配置，並透過 User Data 指定實體起動時所需要執行的工作。
   註: 也有使用 Launch Template 的作法，這篇不會討論。

3. Target Group (TG):
   由 1 到多個 EC2 實體(instance)組成，用來與 ELB(ALB) 搭配。

4. ALB :
   流量負載平衡，與 TG 作為搭配。可以依不同條件轉導到不同 TG

組合零件

這有點像是在玩模型玩具，各個部份的小零件可以組成一個大零件，
再將各個部件結合，完成我所要的功能。
以下是這所需要的各個零件

• Golden Image : 由實際的 EC2 Instance 建立。並包含 Cloud Watch Agent 的配置。
• User Data : Lanuch Configuration 的一個子項目，可以在 EC2 啟動時，執行指定的命令，比如說在 WINDOWS 透過 Powershell 抓取新版程式來建置服務。
• Launch Configuration : 由上述兩個零件 (Gloden Image & User Data) 組成，另外還可以設定 EBS、Plocies 等設定…
• Target Group : 用來存放相關實體(EC2 Instance)的抽象概念, 可以設定 Health Check 來確定實體的健康情況。
• Auto Scaling Group : 透過 Lanuch Configuration 來建立實體，並且可以將實體放入指定的 Target Group 之中。並且可以設定 Policy 來實現 Scaling Out/In.
• ALB : 負載平衡的一種，透過設定，可以將 Request 導到對應的 Target Group。

紀錄

Add CloudWatch Agent

1. Login EC2 Instance

2. 安裝 CloudWatch Agent

3. 準備一個 Json 檔如下

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22

   { "agent": { "logfile": "c:\\ProgramData\\Amazon\\AmazonCloudWatchAgent\\Logs\\amazon-cloudwatch-agent.log" }, "logs": { "logs_collected": { "files": { "collect_list": [ { "file_path": "D:\\logs\\**.log", "log_group_name": "/MY/Service/Worker", "log_stream_name": "{instance_id}", "timezone": "UTC", "timestamp_format": "%Y-%m-%dT%H:%M:%S" } ] } }, "log_stream_name": "default-log-stream", "force_flush_interval": 5 } }

4. 開啟 powershell，切換目錄至 AmazonCloudWatchAgent

   1	cd "C:\Program Files\Amazon\AmazonCloudWatchAgent"

5. 執行以下語法

   1	./amazon-cloudwatch-agent-ctl.ps1 -a fetch-config -m ec2 -c file:yourjsonfile.json -s

站台加入 Health Check

• 加入靜態檔案(ex:check.html)
• IIS Building _80
  
• 設定 Target Group 的 Health Check (ex:/check.html)
  

包成 Gloden Image

1. 機器下 ALB

   

2. 開啟 Ec2LaunchSettings.exe

   

3. 透過 Ec2LaunchSettings 關機

   

4. Waitting Instance Stoped , Create Images

   

Create Launch Configuration

1. Choose AMI
   
2. Choose Instance Type
   
3. Configure details
   
4. Add Storage
   
5. Configure Security Group
6. Review

Create Auto Scaling group

1. Configure Auto Scaling group details
   
2. Configure scaling policies

   略

3. Configure Notifications

   略

4. Configure Tags

   略

5. Review

參考

• 使用 EC2 執行個體建立 Auto Scaling 群組 - Amazon EC2 Auto Scaling
• Launch Configurations - Amazon EC2 Auto Scaling
• 使用 AWS Application Load Balancer
• Network Load Balancers 的目標群組
• 為 Network Load Balancer 建立目標群組
• CloudWatch Logs
• 使用 CloudWatch 代理程式從 Amazon EC2 執行個體和現場部署伺服器收集指標和日誌 - Amazon CloudWatch

(fin)

前情提要

登入 SQL Server 需要受到權限管控，
而在 Windows 中需要使用特定用戶身份登入時，
我們常常會選擇 runas 命令。

原始作法

大概類似如下:

1

runas.exe /netnoly /user:MyCompany\Marsen "C:\Program Files (x86)\Microsoft SQL Server\140\Tools\Binn\ManagementStudio\Ssms.exe"

我會寫成一個 ps (PowerShell) File 來執行這件事。
但是會有一些問題。

問題

1. 每次登入都輸入密碼好麻煩
2. 密碼很長又複雜，Terminal 又看不出輸入是否正確，常常會打錯
3. 密碼如果寫在 PowerShell 中會有風險

我希望點兩下就能以正確的身份開啟 SSMS 而且密碼不會被明碼存儲

CPAU

1. 請先下載CPAU\

   • 我採用綠色安裝，如果有必要可以設為環境變數

2. 加密,以下的語法會產生以 MyCompany\Marsen 的身份登入執行 SSMS 的批次檔 run.bat

   1	CPAU -u MyCompany\marsen -p *************** -ex "C:\Program Files (x86)\Microsoft SQL Server\140\Tools\Binn\ManagementStudio\Ssms.exe" -enc -file D:\run.bat

3. 解密

   1	CPAU -file D:\run.bat -dec

最後只要將步驟 4 的語法存成一個 bat 檔，就可以隨時點兩下執行了。

免責聲明

雖然是加密過的檔案，不過如果被人知道你是使用 CAPU 加密，攻擊者取得檔案後仍然可以透過 CAPU 解密登入。
所以使用上一定要小心檔案不要外流，主要的優點仍然是節省打密碼的時間與打錯的風險。

參考

• Runas
• CPAU
• Rusas 的替代方案 CPAU

(fin)