管理專案

瞭解如何建立及使用專案。

何謂專案?

專案是 Code Engine 實體 (例如應用程式、工作及建置) 的分組。專案以 Kubernetes 名稱空間為基礎。專案名稱在 IBM Cloud® 資源群組、使用者帳戶及地區內必須是唯一的。專案用來管理資源，並提供對其實體的存取權。

專案提供下列項目。

提供實體名稱的唯一名稱空間。
管理對專案資源的存取權 (入埠存取權)。
管理對支持服務、登錄及儲存庫 (出埠存取權) 的存取權。
具有自動產生的傳輸層服務 ( TLS ) 憑證。

如需使用 IAM 管理專案存取控制的相關資訊，請參閱管理使用者存取權。

專案不會產生任何成本，而是作為應用程式、工作及功能的資料夾。

如何查看我可以存取哪些專案?

您可以在 Code Engine 主控台中查看專案清單。

您也可以執行 project list 指令。

ibmcloud ce project list

輸出範例

Getting projects...
OK

Name             ID                                    Status  Selected  Tags  Region    Resource Group  Age
myproj-eude      01234567-abcd-abcd-abcd-abcdabcd2222  active  false           eu-de     default         27d
myproject        01234567-abcd-abcd-abcd-abcdabcd1111  active  true            us-south  default         52d

如何查看專案的詳細資料?

從 Code Engine 主控台中，您可以從 Code Engine 專案頁面按一下專案名稱來查看專案的詳細資料。

當您從主控台處理 Code Engine 中的元件時，例如應用程式、工作或函式，或其相關實體，例如存取、綁定或訂閱，您可以檢視相關專案的詳細資訊。從特定 Code Engine 實體的頁面，按一下詳細資料，以瞭解相關專案的詳細資訊。請利用這個頁面來檢視相關聯專案的詳細資料，其中包括區域、CRN (雲端資源名稱)、GUID (廣域唯一 ID)、網址 (公用及專用) 等資訊!

您也可以執行 project get 指令，以顯示專案的詳細資料。以專案名稱取代 PROJECT_NAME。如果選取您的專案作為現行環境定義，則此指令的輸出包括 Code Engine 專案資源的限制及配額使用情形的詳細資料。如需專案限制的相關資訊，請參閱專案配額。

ibmcloud ce project get --name PROJECT_NAME

輸出範例

Getting project 'myproject'...
OK

Name:                                      myproject
ID:                                        01234567-abcd-abcd-abcd-abcdabcd1111  
CRN:                                       crn:v1:bluemix:public:codeengine:au-syd:a/1a2b3c4d5e6f7g1a2b3c4d5e6f7g1234:01234567-abcd-abcd-abcd-abcdabcd1111::  
Status:                                    active
Enabled:                                   true
Application Private Visibility Supported:  true
Selected:                                  true
Region:                                    us-south
Resource Group:                            default
Service Binding Service ID:                ServiceId-1234abcd-abcd-abcd-1111-1a2b3c4d5e6f
Age:                                       52d
Created:                                   Mon, 30 Jun 2025 18:16:12 +0200
Updated:                                   Mon, 30 Jun 2025 18:16:58 +0200

Connectivity:    
  Outbound - Source IP addresses:                             
    Public internet  
    159.23.99.151  
    130.198.13.241  
    135.90.137.31  

    IBM Cloud private network  
    10.223.236.11  
    10.223.242.142  
    10.12.3.244  

  Inbound - Context-based restrictions for the data plane:    
    Enforcement status:         none  
    Public internet:            allowed  
    IBM Cloud private network:  allowed  
    Last applied:               Wed, 20 May 2026 15:52:02 +0200  

Quotas:
    Category                                  Used       Limit
    App revisions                             33         100
    Apps                                      10         100
    Build runs                                4          100
    Builds                                    4          100
    Configmaps                                7          100
    CPU                                       6.15       64
    Custom domain mappings                    4          80
    Ephemeral storage                         5415750Ki  256G
    Functions                                 2          20
    Instances (active)                        6          250
    Instances (total)                         9          2500
    Job runs                                  4          100
    Jobs                                      3          100
    Memory                                    26400M     256G
    Persistent data stores                    2          10
    Private path connections                  1          3
    Secrets                                   21         100
    Serverless fleets                         42         1000
    Subnet pools                              3          20
    Subscriptions (cron)                      1          100
    Subscriptions (IBM Cloud Object Storage)  0          100

如何設定原則，讓其他人可以使用我的專案?

請參閱管理使用者存取權的相關資訊，以瞭解如何設定 IAM 原則，以便其他人可以使用您的 Code Engine 專案。

是否有專案限制需要考量?

每個區域可以建立的專案數目上限為 20。如需專案限制的相關資訊，請參閱專案配額。

建立專案

您可以透過主控台或 CLI 來建立專案。

從主控台建立專案

從 Code Engine 主控台上的「專案」頁面中，按一下建立。或者，您可以在使用 Code Engine 主控台捷徑建立 Code Engine 應用程式、工作或函數時建立專案。從 Code Engine 主控台中，選取 Let 's go，然後從「開始建立」頁面中按一下 建立專案。
選擇要部署專案的位置。
輸入專案的名稱。對於指定位置內的所有專案，此名稱必須是唯一的。
選擇要建立專案的資源群組。
按一下建立。

若要檢視專案資源的服務實例，請移至 IBM Cloud 儀表板，並在 Code Engine 中尋找您的專案名稱。

使用 CLI 建立專案

當您建立專案時，會自動選取它作為現行環境定義。若要建立未自動選取的專案，請使用 --no-select 選項。

安裝 Code Engine CLI。將您要用於專案的資源群組設為目標。
使用 project create 指令建立專案。請使用對您的區域而言唯一的專案名稱。
```
ibmcloud ce project create --name PROJECT_NAME
```
輸出範例
```
Creating project 'myproject'...
OK
```

驗證已使用 project get 指令建立新專案。

ibmcloud ce project get --name PROJECT_NAME

輸出範例

Getting project 'myproject'...
OK
Name:                       myproject
ID:                         01234567-abcd-abcd-abcd-abcdabcd1111
Status:                     active
Selected:                   true
Region:                     us-south
Resource Group:             default
Service Binding Service ID: ServiceId-1234abcd-abcd-abcd-1111-1a2b3c4d5e6f
Age:                        52d
Created:                    Fri, 15 Jan 2021 13:32:30 -0500
Updated:                    Fri, 15 Jan 2021 13:32:45 -0500

Quotas:
Category                                  Used      Limit
App revisions                             1         100
Apps                                      1         100
Build runs                                0         100
Builds                                    0         100
Configmaps                                2         100
CPU                                       1.025     64
Ephemeral storage                         902625Ki  256G
Instances (active)                        1         250
Instances (total)                         2         2500
Job runs                                  1         100
Jobs                                      1         100
Memory                                    4400M     256G
Secrets                                   5         100
Subscriptions (cron)                      0         100
Subscriptions (IBM Cloud Object Storage)  0         100

您也可以列出所有專案，此輸出會顯示您選取的專案。在下列範例中，myproject 是選取作為現行環境定義的專案。

ibmcloud ce project list

輸出範例

Getting projects...
OK

Name             ID                                    Status  Selected  Tags  Region    Resource Group  Age
myproj-eude      01234567-abcd-abcd-abcd-abcdabcd2222  active  false           eu-de     default         27d
myproject        01234567-abcd-abcd-abcd-abcdabcd1111  active  true            us-south  default         52d

使用專案

建立專案後，您可以使用 Code Engine 主控台或 CLI 來處理專案。

從主控台使用專案

若要使用專案，請跳至 Code Engine 專案頁面，然後從清單中按一下專案名稱。

若要使用 Code Engine 元件，您必須在專案的環境定義中使用元件。從專案的環境定義中，您可以建立並使用 Code Engine 元件，例如應用程式、工作或函數。若要判斷您目前從中工作的專案，請參閱 Code Engine 元件的瀏覽途徑。

使用 CLI 來使用專案

若要使用 CLI 來使用專案，必須選取專案作為現行環境定義。除非您指定 --no-select 選項，否則在建立專案時，會自動選取專案作為現行環境定義。若要選取目前未設為目標的專案，請使用 project select 指令。

ibmcloud ce project select --name PROJECT_NAME

輸出範例

Selecting project 'myproject'...

從所選專案的環境定義內，您可以使用 Code Engine 元件，例如應用程式、工作或函數。

判斷選取哪個專案作為現行環境定義

您可以使用 project current 指令，來尋找選取作為現行環境定義之專案的詳細資料。

刪除專案

當您不再需要專案時，您可以刪除它。刪除專案會刪除它包含的所有元件。您可以使用主控台或 CLI。

當您從主控台或使用 CLI 刪除專案時，它會被軟刪除且可以還原。您必須在 7 天內還原專案，否則它會永久刪除。如需還原專案的相關資訊，請參閱還原已刪除的專案。如果要永久刪除專案，請參閱永久刪除專案。

當您刪除專案時，任何未永久刪除的專案都會計入每個區域容許的專案總數上限 20 個。

區域內的專案名稱必須是唯一的。當您軟刪除專案 (或使用收回來刪除專案) 時，除非永久刪除專案，否則無法重複使用專案名稱。

從控制台刪除專案

若要從主控台刪除專案，請移至 Code Engine 專案頁面。如果您開啟特定的專案，也可以從動作功能表中刪除專案。

當您從主控台刪除專案時，專案會被軟刪除，可在永久刪除之前的 7 天內還原。專案收回代表仍可還原的已刪除專案。從 Code Engine 專案頁面中，會顯示專案收回數目。按一下 restorable projects 以開啟「專案收回」頁面，並顯示可還原或永久刪除的專案清單。

使用 CLI 刪除專案

若要使用 CLI 來刪除專案，請使用 project delete 指令。您可以選擇性地使用 -f 選項來強制刪除專案，而不進行確認。在軟刪除專案之後，您可以使用 reclamation 指令來管理此專案。下列範例軟刪除 myproject 專案，

ibmcloud ce project delete --name myproject -f

輸出範例

Deleting project 'myproject'...
OK

如果要永久刪除專案，使其無法還原，請在 project delete 指令中指定 --hard 選項。您可以選擇性地使用 -f 選項來強制刪除專案，而不進行確認。下列範例會永久刪除 myproject1 專案，

ibmcloud ce project delete --name myproject1 --hard -f

輸出範例

Deleting project 'myproject1'...
OK

--hard 如果您在 project delete 指令，專案會立即被刪除，且無法使用 IBM Cloud 資源回收來還原。如果您未指定 --hard 選項，則可以使用 reclamation restore 指令，在 7 天內還原專案。

如果您先前已軟刪除專案 (未指定 --hard 選項)，則只能使用 project delete 指令與 --hard 選項搭配來指定後續刪除。此動作會完全刪除專案，因此無法還原。

還原已刪除的專案

從主控台還原已刪除的專案

在軟刪除專案之後，您可以從主控台還原或永久刪除專案。您必須在 7 天內還原專案，否則它會永久刪除。

從 Code Engine 主控台上的「專案」頁面中，檢視您地區中的專案清單。即會顯示專案收回數目。
按一下 project reclamations 的鏈結。
從 專案收回 頁面中，您可以檢視可以還原專案的剩餘天數。
- 若要還原專案，請按一下還原圖示。
- 如果要永久刪除您的專案，請按一下刪除圖示。

如果您未對 專案收回 頁面上列出的專案採取任何動作，則專案會在 7 天之後自動永久刪除。

使用 CLI 還原已刪除的專案

可以使用 reclamation 指令來管理軟刪除的專案。reclamation 指令。

使用 reclamation list 指令來探索軟刪除的專案。

ibmcloud ce reclamation list

輸出範例

Getting project reclamations...
OK
Name          ID                                    Reclamation ID                        Status        Region    Resource Group  Age   Time to Hard Deletion
myproject     def218c5-abcd-abcd-abcd-97854c288d76  48e3d7a2-abcd-abcd-abcd-99db7152b8fe  soft deleted  us-south  default         40h   6d23h
myproject2    01f0bc66-abcd-abcd-abcd-3ef7e99f6f69  af2cd017-abcd-abcd-abcd-d32e2bb79136  soft deleted  jp-osa    default         8m58s 2d11h

使用 reclamation restore 指令，將軟刪除專案還原至作用中狀態。下列範例會還原 myproject2 專案及其元件。請確定您的目標是您要還原之專案的正確區域。
```
ibmcloud ce reclamation restore --name myproject
```
輸出範例
```
Restoring project 'myproject'...
OK
```

或者，您可以使用 project restore 指令，將軟刪除專案還原至作用中狀態。

永久刪除專案

從主控台永久刪除專案

在軟刪除專案 (或使用收回來刪除專案) 之後，您可以從主控台還原它或永久刪除它。當專案永久刪除時，無法還原。

從 Code Engine 主控台上的「專案」頁面中，檢視您地區中的專案清單。即會顯示專案收回數目。
按一下 project reclamations 的鏈結。
從 專案收回 頁面中，您可以檢視可以還原專案的剩餘天數。若要永久刪除專案，請按一下 Delete。

如果您未對 專案收回 頁面上列出的已刪除專案採取任何動作，則專案會在 7 天之後自動永久刪除。

使用 CLI 永久刪除專案

如果您的專案已軟刪除，您可以使用 reclamation delete 指令來永久刪除專案。在這個指令中使用 --force 選項，會強制刪除而不確認。

ibmcloud ce reclamation delete -n myproject --f

輸出範例

Hard deleting project 'myproject'...
OK

如果您的專案未正常刪除，則若要永久刪除專案，使其無法還原，請在 project delete 指令中使用 --hard 選項，指定立即永久刪除專案。例如，若要永久刪除 myproject3 專案，請執行下列動作:

ibmcloud ce project delete --name myproject3 --hard

輸出範例

Deleting project 'myproject3'...
OK