多個 site 與 app
大型組織常有多個 site、多個 Jira 或 Confluence instance。這一節考你在既有 organization 新增 app、理解 site URL 與 app URL、把 app 轉移到另一個 organization,以及設定 landing app。
官方考綱原文(這一節會考的範圍)
- Administer users and groups across multiple Cloud organizations, sites, and products跨多個 Cloud organization、site、app 管理使用者與 group(新版能力清單)
- Create a new product and site under an existing organization在既有 organization 底下建立新的 app 與 site(舊版 1.2)
- Understand the nuances of multiple sites and products理解多個 site 與 app 的差異與限制(舊版 1.2)
- Understand site URLs and product URLs理解 site URL 與 app URL(舊版 1.2)
- Transfer products to another organization把 app 轉移到另一個 organization(舊版 1.2)
- Set landing product for a site設定 site 的 landing app(舊版 1.2)
多個 site、app URL、轉移與 landing app
- Organization、site、appOrganization 集中管理使用者、安全與帳單。Site 是一個網址(xxx.atlassian.net),同一個 site 上的 app 共用這個網址,而且每個 site 有自己的帳單。
- 一個方案一個 instanceFree、Standard、Premium 方案各只給一個 app instance;Enterprise 方案可以在同一個方案下有最多 150 個 instance。
- 新增 appOrg admin 在 Apps → Atlassian apps → Add app 加入新 app。新 app 從 Standard 或 Premium 試用開始,沒有付款資料時,試用結束會改成 Free。
- 改 URLApps → App URLs → Update URL 只能改 atlassian.net 前面的 subdomain,整個 site 的 app 一起改。舊網址在瀏覽器會自動轉址,但 REST API 呼叫舊網址會失敗(401)。
- 轉移 app在要淘汰的 organization 選 Organization settings → Profile → Transfer apps。兩邊都要是 org admin,而且只適用 original user management;轉移不能復原。
- Landing app使用者打開 site 網址時先看到的 app,只能選 Jira 或 Confluence。最多兩小時生效;沒有該 app 存取的人會被提示申請存取。
資料來源(5)有疑慮時點開看官方原文
- What are the benefits of multiple instances?
Free, Standard, and Premium plans entitle you to one app instance.
- Add a new Atlassian app or collection to your organization
We start you on a free trial of the app or collection, either on a Standard or Premium plan.
- Update an app URL subdomain
While we redirect links to the new URL in a browser, calls to the REST API will fail with a 401 error.
- Transfer all apps to another organization
Transferring apps is not available in organizations with the centralized user management experience.
- Set your site’s landing app
You can only set the landing app to Jira or Confluence.
Organization、site 與 app instance
| 層次 | 是什麼 | 考點 |
|---|---|---|
| Organization | 把公司的使用者與 app 集中管理的單位;org admin 在 Atlassian Administration(admin.atlassian.com)管理它 | 使用者、group、安全政策與帳單都在這一層設定 |
| Site | 一個網址,例如 labjira.atlassian.net;第一次註冊 app 時取的 site 名稱,會變成網址的 subdomain | 每個 site 有自己的帳單;改 URL 也是以 site 為單位 |
| App instance | 某個 app 的一份獨立副本,例如 labjira 上的 Jira 與 labjira2 上的 Jira 是兩個 instance | 內容很難在 instance 之間搬移,所以官方建議事先規劃 |
為什麼要分成多個 instance?官方列出四類理由。第一是管理自主:把某些 instance 的 app 管理交給團隊自己做,敏感或公開的 instance 留在中央控管。第二是安全與資料隔離:每個 instance 可以分別控制誰能存取與管理、audit log 的層級與資料存放地區。第三是併購:先把對方的 instance 收進 organization 集中管理,使用者照常在原本的 instance 工作。第四是Marketplace 成本:每個 instance 分別訂閱 Marketplace app,計費人數也分開算。
「公司想讓研發與法務各用一個 Jira instance、資料彼此隔離,又希望放在同一個方案底下」:Enterprise 方案可以在同一個方案下有最多 150 個 instance;Free、Standard、Premium 方案每個只有一個 instance,要多個就得分別訂閱。
資料來源(5)有疑慮時點開看官方原文
- What are the benefits of multiple instances?
An Enterprise plan allows you to have up to 150 app instances in the same plan.
- What are the benefits of multiple instances?
Separate instances allow you to delegate app administration for some instances and maintain centralized control of others.
- What are the benefits of multiple instances?
Because it can be difficult to move content between instances, it’s best to plan how to structure your instances in advance.
- Explore an Atlassian organization
Your organization likely has multiple bills. Sites have separate bills.
- Create an Atlassian organization
We’ll ask you to enter a name for your site, which becomes the subdomain in the URL for this app.
在既有 organization 加 app 與 site
- 位置Atlassian Administration›Apps›Atlassian apps,按 Add app,依提示設定 app,最後按 Add/Start trial。
- 方案新加的 app 從 Standard 或 Premium 的免費試用開始;試用結束後開始計費。如果沒有付款資料,app 會改成 Free 方案。
- 建好之後建立可能要幾分鐘,完成後會寄 email 通知,app 也會出現在 organization 的 app 清單。
- 誰能做Org admin 可以把 app 加進 organization;site admin 只能在自己管理的 site 上加 app。
| 情況 | 怎麼處理 |
|---|---|
| Jira Align、Strategy Collection | 不能自己從 Atlassian Administration 加,要聯絡 Atlassian 代為加入 |
| Jira Product Discovery | 可以加到既有的 site,但不能開在新的 site |
| Trello | 不能加進 organization;要在 Trello Enterprise admin dashboard 把它連結(link)到 organization |
| Bitbucket workspace | 在 Atlassian apps 頁的 More actions 選 Link Bitbucket;連結後原本的使用者存取、group 權限與帳單都不會改變 |
| Enterprise 方案 | 同一個 Enterprise 方案可以加到最多 150 個 app instance |
現有客戶從 www.atlassian.com 也能開新 app,但官方建議從 Atlassian Administration 加,才能確定 app 是加在既有的 organization 底下。
資料來源(5)有疑慮時點開看官方原文
- Add a new Atlassian app or collection to your organization
While existing customers can add an app from www.atlassian.com, we recommend following the steps on this page to add apps from Atlassian Administration.
- Add a new Atlassian app or collection to your organization
If we don’t have your payment details, we will change your app to a Free plan.
- Add a new Atlassian app or collection to your organization
You can add Jira Product Discovery to an existing site, but not a new site.
- Add a new Atlassian app or collection to your organization
You can’t add Trello to your organization, but you can link it to your organization in the Trello Enterprise admin dashboard.
- What are the different types of admin roles?
This includes adding new apps to the site and managing Marketplace apps installed on the site.
Site URL、app URL 與 custom domain
- 位置Atlassian Administration›Apps›App URLs,在要改的 site 那一列按 Update URL。
- 輸入新名稱至少 3 個字元,可用小寫英文字母、數字,連字號只能放在中間。
- 確認按 Continue,畫面會列出會一起改用新網址的 app,再按 Update。最多 5 分鐘完成。
| 改 app URL 的 subdomain | Custom domain | |
|---|---|---|
| 網址長什麼樣 | acme.atlassian.net:只能改 atlassian.net 前面那段 | customer.help.acme.com:使用公司自己的網域 |
| 方案條件 | 該 site 至少要有一個 Standard、Premium 或 Enterprise 方案的 Jira 或 Confluence | 要 Jira Premium、Confluence Premium 或 Jira Service Management Standard |
| 要不要改 DNS | 不用改 DNS,幾乎立即可用 | 要在 DNS 加幾筆紀錄證明擁有網域,生效需要時間 |
| 次數與重用 | 有次數上限;用過的網址不能再用 | 沒有次數限制,也能重用以前的網域名稱 |
| 支援範圍 | 相容所有 Marketplace 與第三方整合 | 只支援 Jira 家族、JSM help center 與 Confluence,也不一定相容所有整合 |
- 改完之後,舊網址會記在 site 的歷史裡,所有連結(例如 Jira issue、Confluence 頁面)都會轉到新網址,所以舊網址也不能給別的 site 用。
- REST API 整合要改用新網址:瀏覽器會轉址,但 API 呼叫舊網址會回 401。Partner-built apps 可能要重新設定或重新安裝。
- Sandbox 的 URL 不會跟著改;想改 sandbox 網址要重建 sandbox,或用 sandbox 自己的 Update sandbox URL。
- Jira 與 Jira Service Management 的 Atlassian email 地址會改成新 site 名稱的格式,新舊地址都能收信。
Update an app URL subdomain 頁寫 subdomain 最多可以改 15 次;Can I update the URL 頁的限制清單與比較表則寫不能超過 3 次。作答時抓住共同點:次數有上限、用過的網址不能再用。方案條件也不一致:Update 頁的 Who can do this 方框列 Jira Premium、Confluence Premium 或 Jira Service Management Standard,內文寫要有至少一個付費 app;Can I update 頁則寫該 site 要有 Standard、Premium 或 Enterprise 的 Jira 或 Confluence。
資料來源(7)有疑慮時點開看官方原文
- Can I update the URL used to access an app?
The update applies to all apps in that site. You can’t update the URL for individual apps within the same site.
- Can I update the URL used to access an app?
You must have at least one Jira or Confluence app with a Standard, Premium, or Enterprise plan in that site.
- Update an app URL subdomain
The update may take up to 5 minutes to complete. You can update the subdomain up to 15 times.
- Can I update the URL used to access an app?
You can’t update an app URL more than 3 times.
- Can I update the URL used to access an app?
Custom domains are available with a Jira Premium, Confluence Premium, or a Jira Service Management Standard plan.
- Update an app URL subdomain
The URL for any sandboxes will not be updated automatically.
- Update an app URL subdomain
You need to be an organization admin to do this, and have at least one paid app.
把 app 轉移到另一個 organization
| 轉移前要先處理的設定 | 做法 |
|---|---|
| SAML SSO、user provisioning | 先在 Atlassian 這端中斷連線(不要 de-provision group,才能保留 group 與權限),轉移後在新 organization 重新連 IdP |
| Admin API keys | 在 API keys 頁撤銷;轉移後在新 organization 建新的 key,並更新整合 |
| Atlassian Guard 訂閱 | 先取消,轉移後重新訂閱 |
| Enterprise 方案 | 先取消,轉移後重新訂閱 |
| Rovo 訂閱與 AI | Rovo 訂閱要請 billing support 停用;每個 app 的 AI 也要先在 Rovo → Rovo access 關掉,轉移後再開 |
| Domains 與 email domains | 已驗證與未驗證的都要移除,轉移後在新 organization 重新驗證(DNS 最多可能要 72 小時) |
| Approved domains、user invites、invitation links | 在目的 organization 的每個 site 重新設定 |
不會改變
- 使用者不會停機,app 存取與權限不變
- App 保留原本的 URL、權限、projects、spaces
- 原本的 app admin、site admin 仍是 admin
- 同樣的 app 不會合併,會變成多個 instance
會改變
- 來源 organization 的 org admin 會變成目的 organization 的 org admin,也成為所有 site 的 site admin
- 這些 admin 若因此拿到原本沒有的 app 存取,帳單可能增加
- SSO 還沒在新 organization 設好前,使用者可能要暫時設密碼登入
- 空的 organization 會被刪除
「兩家公司合併,要把 B 公司的 Jira 搬到 A 公司的 organization」:在 B 的 organization 執行 Transfer apps,你必須同時是兩邊的 org admin。如果任一邊是 centralized user management,就不能自助轉移,要聯絡 Atlassian support。
資料來源(6)有疑慮時點開看官方原文
- Transfer all apps to another organization
You need to be an organization administrator in both organizations to do this.
- Transfer all apps to another organization
The transfer process is permanent and can’t be undone.
- Transfer all apps to another organization
Anyone who is an organization admin in the original organization will become an organization admin of the destination organization, which means they’ll become a site admin for all sites.
- Transfer all apps to another organization
Transferred apps remain separate. If both organizations had the same apps, you’ll have multiple app instances after the transfer (nothing will be merged).
- Transfer all apps to another organization
Once the app instances and account data have been transferred, we’ll delete the empty organization.
- Transfer all apps to another organization
If your organization has a Rovo subscription, you’ll need to contact our billing support team to deactivate Rovo before you start the transfer.
使用者登入 site 時先看到哪個 app
| Centralized user management | Original user management | |
|---|---|---|
| 誰能設定 | Org admin | Org admin 或 site admin |
| 位置 | Apps → Atlassian apps → Add app 旁的 More actions → Update landing app | Apps → 選 site → App access,在 What you need to know 那段按 Change this setting |
| 可以選的 app | Jira 或 Confluence | Jira 或 Confluence |
| 多久生效 | 最多兩小時 | 最多兩小時 |
如果使用者沒有 landing app 的存取,系統仍會把他帶到這個 app,並提示他申請存取。推論:設成 Confluence 之前,先確認大部分使用者都有 Confluence,否則通常會多出不少 access request。
資料來源(4)・1 點無官方原文有疑慮時點開看官方原文
- Set your site’s landing app
From the More actions () menu next to Add app, select Update landing app.
- Set your site’s landing app
It can take up to two hours for this change to take effect.
- Set your site’s landing app
If a user doesn't have access to the landing app, we'll land them in your selected app and prompt them to request access.
- Set your site’s landing app
As a site admin, you can choose the app that your users see first when they log in to your site.
- 找不到官方原文:設 landing app 前先確認使用者有該 app 存取官方只寫沒有存取的人會被提示申請存取;「會多出 access request」是依此推論的實務建議。
考題愛用的錯誤說法
資料來源(6)有疑慮時點開看官方原文
- Can I update the URL used to access an app?
The update applies to all apps in that site. You can’t update the URL for individual apps within the same site.
- Update an app URL subdomain
While we redirect links to the new URL in a browser, calls to the REST API will fail with a 401 error.
- Set your site’s landing app
You can only set the landing app to Jira or Confluence.
- Transfer all apps to another organization
Transferred apps remain separate. If both organizations had the same apps, you’ll have multiple app instances after the transfer (nothing will be merged).
- What are the benefits of multiple instances?
Free, Standard, and Premium plans entitle you to one app instance.
- Transfer all apps to another organization
Transferring apps is not available in organizations with the centralized user management experience.
實作 Lab:加第二個 site,再換 landing app
第一次做 Lab?先看 Lab 環境準備:用測試站台、準備測試帳號。畫面名稱可能隨 Atlassian 更新而不同,以下以現行畫面為準。
目標:親眼看一個 organization 底下的多個 site 與 app,看 App URLs 頁怎麼以 site 為單位改網址,再把 landing app 換掉、用 Leo 的視角看結果。
Site 是網址與帳單單位,改 URL 是整個 site 一起改;landing app 只能選 Jira 或 Confluence,最多兩小時生效;Transfer apps 在要淘汰的 organization 執行,centralized user management 不能自助轉移。
準備
- Leo 只有 labjira 的 Jira 存取,沒有 Confluence 存取。
- 如果還沒建 labjira2,步驟 2 會建。
步驟
- 你應該看到:看到 labjira 上的 Jira 與 Confluence;如果已經建了 labjira2,也會看到它的 Jira。每個 app 通常會標出它所在的 site 網址。
- 你應該看到:建立要幾分鐘,完成會收到 email;新的 Jira 從 Standard 或 Premium 試用開始,試用結束沒有付款資料會變成 Free。
- 你應該看到:一列是一個 site;labjira 那一列同時列出 Jira 與 Confluence,代表它們會一起換網址。輸入框要求至少 3 個字元。官方規定該 site 要有 Standard 以上(付費)的 Jira 或 Confluence;labjira 若都還是 Free,Update URL 可能是停用狀態,那就只看 labjira2 那一列。
- 你應該看到:下拉選單只有 Jira 與 Confluence 可以選;每個 site 各有一個設定。
- 你應該看到:生效後 Leo 會被帶到 Confluence,並看到申請存取的提示,因為他沒有 Confluence 存取。先不要送出申請(520.3.2 再處理)。
- 你應該看到:Lab Org 用的是 centralized user management(Users 在 Directory 底下),官方說這種 organization 不能自助轉移 app;畫面上通常看不到可用的 Transfer apps,或會引導你聯絡 support。
試試看:改一個設定,觀察差異
T1(想像,不實際做)把 labjira 的 URL 改成 labjira-new。看結果
T2在 Update landing app 的下拉選單找看看有沒有 Jira Service Management 或其他 app。看結果
T3(想像,不實際做)把 labjira2 轉移到另一個 organization。看結果
Atlassian apps 頁右上角:Add app 按鈕旁邊的 ••• 選單,裡面有 Update landing app。落地只有 J 和 C。
收尾
- 把 labjira 的 landing app 改回 Jira。
- labjira2 留著給後面的 Lab 用;試用期結束沒有付款資料會自動變 Free。
資料來源(5)有疑慮時點開看官方原文
- Add a new Atlassian app or collection to your organization
Select Apps, then Atlassian apps, then Add app.
- Update an app URL subdomain
Select Apps, then App URLs.
- Can I update the URL used to access an app?
You must have at least one Jira or Confluence app with a Standard, Premium, or Enterprise plan in that site.
- Set your site’s landing app
From the More actions () menu next to Add app, select Update landing app.
- Set your site’s landing app
If a user doesn't have access to the landing app, we'll land them in your selected app and prompt them to request access.
讀完了?用這張收攏整節
- Free/Standard/Premium:一個方案一個 instance;Enterprise:同一方案最多 150 個。
- Site 是網址單位,也是帳單單位;instance 之間很難搬內容,要先規劃。
- 新增 app:Apps → Atlassian apps → Add app。
- 試用結束沒有付款資料就變 Free;JPD 只能加到既有 site。
- 改 URL 是整個 site 一起改,不能只改一個 app。
- 舊網址在瀏覽器會轉址,REST API 會回 401。
- Custom domain:Jira/Confluence Premium 或 JSM Standard,而且要加 DNS 紀錄。
- Transfer apps 在要淘汰的 organization 執行,兩邊都要是 org admin。
- 轉移不能復原;同類 app 不會合併。
- 來源 org admin 會變成目的 org 的 org admin 與所有 site 的 site admin。
- Landing app 只能是 Jira 或 Confluence,每個 site 各設一個。
- Centralized 只有 org admin 能設;original 介面 site admin 也能設。
做題
題目載入中…
本教材為原創整理,非 Atlassian 官方出版品;題目皆為原創,不含第三方題庫題幹。官方文件近年改用新名稱:product 改稱 app、Atlassian Access 改為 Atlassian Guard、project 改稱 space。考試與舊文件的說法並陳。