在這個部分的課程中，我們可以了解下列事項： 遠端存取介面的架構。 如何開啟 Java 執行環境的遠端請求處理器。 如何利用 appcfg 進行應用程式的維護作業。 如何利用 appcfg 下載記錄檔。

適合用來進行維護的作業。 Datastore 下載與備份。 Datastore 大量修改。 Datastore 維護 CSV 上傳 下載 CSV 遠端存取介面與 Google App Engine 之間的溝通是透過加密的通道，不會應該還是必須限制只有管理者才能夠使用。 分成兩個部分 遠端請求處理器 (Remote API request handler) : 同時提供 Python 與 Java 的執行環境使用。 工具與函式庫 (tools and libraries) : 僅提供 Python 語言的工具。 Python 與 Java 的工具都使用相同的方式與 Google App Engine 溝通。 在 Java 執行環境下使用遠端工具必須安裝 Python 的 SDK。

在 web.xml 中設定 RemoteApiServlet 的對應關係，啟用遠端請求處理器。 特別要注意的是必須限制管理者才能夠連結此一網址。

如果直接使用瀏覽器進行連結，將會出現錯誤訊息。 雖然如此，我們仍舊可以藉此確認遠端請求處理器已經正常開啟。 因為遠端介面的工具僅提供 Python 版本，所以在此就先略過不談。

appcfg update path_to_war_archieve Google App Engine 只提供應用程式檔案的上傳，並不提供下載的服務。 當你更新一個應用程式時，有可能有些使用者會繼續使用到原先的程式。儘管這個時間可能僅有數秒之久，但是在更新應用程式時仍舊必須加以考量。 如果應用程式較大，或是變動的幅度較大，為了保險起見最好遵照下列的做法： 如果上傳的版本編號跟預設版本不一樣，那麼可以直接上傳。待上傳並進行線上測試無誤後才正式上線。 如果上傳的版本編號跟預設版本一樣，就需先上傳 datastore 的 indexes。等到 index 建立完成並可以使用後，才更新應用程式。

除了上傳應用程式外，命令列工具還可以用來上傳可擴充服務的設定檔 appcfg update_indexes path_to_war_archieve -> 更新 datastore-indexes.xml appcfg update_queue path_to_war_archieve -> 更新 queue.xml appcfg update_cron path_to_war_archieve -> 更新 cron.xml

下載檔案內的紀錄格式為 Apache Combined (NCSA Combined)。 可以透過 vhost 參數下載特定虛擬主機的紀錄，例如用來下載特定版本的相關訊息。不過此功能目前僅限於 Python SDK 的工具。

每一筆記錄包含下列欄位，當相對應欄位沒有數值時，會以 “-” 做為標示。 客戶端的 IP 位址 沒有使用，僅為了相容性而保留 使用者的 Google 帳號信箱 請求的日期 請求的指令 回應的狀態碼 回應的大小 Referrer 使用者代理程式，通常是標示瀏覽器的種類與其所支援功能

下載應用程式的紀錄檔，需要指定訊息等級。命令列工具只會下載指定等級以上的訊息。 事件等級從 0 (debug) 到 5 (critical)。 存取紀錄只保留 90 天，而應用程式訊息每個等級最多只能保留 1000 筆，因此如果有需要這些紀錄就必須定時下載至別的地方保存。 --append 參數可以下載新的紀錄並自動附加到原先已下載的檔案內，不過此功能目前僅限於 Python SDK 的工具。

輸出的檔案會將同一次請求的訊息彙整在一起，每一個訊息有下列資訊 事件等級 (數字) : 時間戳記 Logger 名稱 函式名稱 訊息內容

Google App Engine Google 應用服務引擎

第八部分 應用程式 維護作業

安裝 Java SDK (1.5 或是 1.6) 安裝 Eclipse (3.3、3.4 或是 3.5) 安裝 Eclipse 的 plugin (會同步安裝 Google 應用程式的 SDK) 使用 Ant (Optional) 建立 Java 開發環境 遠端存取介面

相關操作

謝謝您! cyril.hcwang@gmail.com