CE_SERVICES 환경 변수

CE_SERVICES 환경 변수에는 서비스 인스턴스와 상호작용하는 데 사용할 수 있는 정보가 포함되어 있습니다. 이 환경 변수는 키 값 쌍이 포함된 JSON 오브젝트를 가리킵니다. 이러한 키-값 쌍은 애플리케이션, 작업 또는 함수에 바인딩된 각 서비스 유형을 나타냅니다. key는 서비스 유형의 이름(예: cloud-object-storage)이고, value는 해당 유형의 바인딩된 서비스 인스턴스에 대한 인증 정보 배열입니다.

다음 예제는 CE_SERVICES 변수를 보여줍니다.

{
  "appid": [
    {
      "credentials": {
        "apikey": "xxxxxx",
        "appidServiceEndpoint": "https://us-south.appid.cloud.ibm.com",
        "clientId": "abcdabcd-xxxxxxxx",
        "discoveryEndpoint": "https://us-south.appid.cloud.ibm.com/oauth/v4/xxxxxxxx/.well-known/openid-configuration",
        "iam_apikey_description": "Auto-generated for key crn:v1:bluemix:public:appid:us-south:a/abcdabcd719f45b98a931f6e20db1bd8:xxxxxxxx:resource-key:abcdabcd-xxxxxxxx",
        "iam_apikey_name": "ce-service-access-abcd",
        "iam_role_crn": "crn:v1:bluemix:public:iam::::serviceRole:Writer",
        "iam_serviceid_crn": "crn:v1:bluemix:public:iam-identity::a/abcdabcd719f45b98a931f6e20db1bd8::serviceid:ServiceId-6d7087e5-0611-4240-9e46-af8a4c15cba4",
        "managementUrl": "https://us-south.appid.cloud.ibm.com/management/v4/xxxxxxxx",
        "oauthServerUrl": "https://us-south.appid.cloud.ibm.com/oauth/v4/xxxxxxxx",
        "profilesUrl": "https://us-south.appid.cloud.ibm.com",
        "secret": "abcdabcdYTAtZmU0MC00YTQ1LTliY2YtMDk0ODg0NDMyNDgw",
        "tenantId": "xxxxxxxx",
        "version": 4
      },
      "name": "App ID-yn",
      "plan": "c0258a22-160a-403b-845d-1588ad61204c",
      "resourcekey_name": "ce-service-access-abcd",
      "resourcekey_id": "abcdabcd-xxxxxxxx"
    }
  ],
  "cloud-object-storage": [
    {
      "credentials": {
        "apikey": "xxxxxx",
        "endpoints": "https://control.cloud-object-storage.cloud.ibm.com/v2/endpoints",
        "iam_apikey_description": "Auto-generated for key crn:v1:bluemix:public:cloud-object-storage:global:a/abcdabcd719f45b98a931f6e20db1bd8:abcdabcd-34b3-4edf-95b7-abcdabcdabcd:resource-key:abcdabcd-96e0-46ef-b805-31288524f194",
        "iam_apikey_name": "ce-service-access-c5yn1",
        "iam_role_crn": "crn:v1:bluemix:public:iam::::serviceRole:Writer",
        "iam_serviceid_crn": "crn:v1:bluemix:public:iam-identity::a/abcdabcd719f45b98a931f6e20db1bd8::serviceid:ServiceId-ee6394cb-f203-4c3c-9152-ac886a3f66bb",
        "resource_instance_id": "crn:v1:bluemix:public:cloud-object-storage:global:a/abcdabcd719f45b98a931f6e20db1bd8:abcdabcd-34b3-4edf-95b7-abcdabcdabcd::"
      },
      "name": "Cloud Object Storage-56",
      "plan": "2fdf0c08-2d32-4f46-84b5-32e0c92fffd8",
      "resourcekey_name": "ce-service-access-c5yn1",
      "resourcekey_id": "abcdabcd-96e0-46ef-b805-31288524f194"
    }
  ]
}

Prefix 메소드

prefix 접두부를 사용하면 서비스 인증 정보 오브젝트의 인증 정보 변수 각각에 대해 밑줄로 구분된 대문자의 공통 환경 변수 구문(예: VARIABLE_NAME)을 사용하여 사용자 환경에 해당 변수가 개별적으로 제공됩니다.

기본적으로 변수 이름은 서비스 이름, 인증 정보 변수 이름 순으로 구성됩니다. 예를 들어, apikey 라는 이름의 IBM Cloud Object Storage 서비스 자격 증명 변수는 CLOUD_OBJECT_STORAGE_APIKEY 라는 환경 변수를 통해 사용할 수 있습니다. 다음 예에서는 IBM Cloud Object Storage 서비스 인스턴스 바인딩에 대해 작성된 환경 변수를 보여줍니다.

CLOUD_OBJECT_STORAGE_APIKEY=xxxxxx
CLOUD_OBJECT_STORAGE_ENDPOINTS=https://control.cloud-object-storage.cloud.ibm.com/v2/endpoints
CLOUD_OBJECT_STORAGE_IAM_APIKEY_DESCRIPTION=Auto-generated for key abcdabcd-abcd-abcd-abcd-abcdabcdabcd
CLOUD_OBJECT_STORAGE_IAM_APIKEY_NAME=my-object-storage-codeengine-credential
CLOUD_OBJECT_STORAGE_IAM_ROLE_CRN=crn:v1:bluemix:public:iam::::serviceRole:Manager
CLOUD_OBJECT_STORAGE_IAM_SERVICEID_CRN=crn:v1:bluemix:public:iam-identity::a/1176a104ad4441e6b0aa92ed0b60b15c::serviceid:ServiceId-abcdabcd-abcd-abcd-8b41-531fc64e640e
CLOUD_OBJECT_STORAGE_RESOURCE_INSTANCE_ID=crn:v1:bluemix:public:cloud-object-storage:global:a/1176a104ad4441e6b0aa92ed0b60b15c:11179ac4-abcd-4887-abcd-d330a430abcd::
CLOUD_OBJECT_STORAGE_SERVICENAME=my-object-storage

기본적으로 동일한 유형의 둘 이상의 인스턴스가 단일 애플리케이션에 바인드된 경우 Code Engine은 CLOUD_OBJECT_STORAGE_2_APIKEY와 같은 인덱스를 서비스 이름에 추가합니다.

각 서비스 바인딩은 사용자 지정 환경 변수 접두사를 사용하도록 구성할 수 있습니다. 콘솔을 사용하는 경우, 서비스 바인딩을 생성할 때 접두사를 선택적으로 제공할 수 있습니다. --prefix CLI를 사용하는 경우, app bind, 그 job bind, 또는 function bind 명령.

이전 구현을 사용하는 서비스 바인딩을 대체하려면 어떻게 해야 합니까?

애플리케이션이나 작업에 이전 구현 방식을 사용하는 서비스 바인딩이 있고, 여기에 새로운 서비스 바인딩을 추가하려는 경우, 새로운 바인딩을 생성하기 전에 먼저 이전 구현 방식을 사용하는 바인딩을 제거해야 합니다. 필요한 경우 기존 서비스 바인딩을 다시 작성할 수 있습니다.

바인딩을 해제하고 다시 바인딩하는 동안 애플리케이션이 완전히 작동하지 않을 수 있습니다.

1. 사용 중인 애플리케이션이나 작업이 이전 버전의 서비스 바인딩 구현을 사용하는지 확인하려면 다음 명령을 실행하십시오. app get 또는 job get 명령을 실행하십시오. 이전 서비스 바인딩 구현을 사용하는 경우, 이 명령어의 출력 결과에는 해당 정보와, 다른 서비스를 애플리케이션이나 작업에 바인딩하기 위해 사용해야 하는 명령어가 표시됩니다. 예를 들면 다음과 같습니다.

   ibmcloud ce app get --name myapp
   

   출력 예

   Run 'ibmcloud ce application events -n myapp' to get the system events of the application instances.
   Run 'ibmcloud ce application logs -f -n myapp' to follow the logs of the application instances.
   OK
   This application uses a previous service binding implementation.
   Your application will continue to function normally.
   To bind an additional service to this application, delete and re-create those service bindings with the improved implementation.
   Your application might not be fully functional during the process of unbinding and rebinding.
   Re-create the existing service bindings by issuing the following commands:
   (1) Remove all existing service bindings from this application.
   ibmcloud ce application unbind --name myapp -all
   (2) Bind the services again.
   ibmcloud ce application bind --name myapp --service-instance myobjectstorage --prefix CLOUD_OBJECT_STORAGE
   Name:               myapp
   ID:                 abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
   Project Name:       myproject
   Project ID:         01234567-abcd-abcd-abcd-abcdabcd1111
   Age:                2m4s
   Created:            2021-09-09T14:01:02-04:00
   URL:                https://myapp.abcdabcdabc.us-south.codeengine.appdomain.cloud
   Cluster Local URL:  http://myapp.abcdabcdabc.svc.cluster.local
   Console URL:        https://cloud.ibm.com/codeengine/project/us-south/01234567-abcd-abcd-abcd-abcdabcd1111/application/myapp/configuration
   Status Summary:     Application deployed successfully
   [...]
   Service Bindings:
   Service Instance    Service Type           Environment Variable Prefix
   myobjectstorage     cloud-object-storage   CLOUD_OBJECT_STORAGE
   

   마찬가지로, 작업을 사용하는 경우에는 ibmcloud ce job get --name JOB_NAME 명령을 실행하여 더 이상 사용되지 않는 바인딩이 작업에 사용되었는지 확인하십시오.

2. 이전 구현을 사용하는 기존 서비스 바인딩을 바인드 해제하십시오. --all 옵션은 이 애플리케이션의 모든 서비스 인스턴스를 바인딩 해제하도록 지정합니다.

   ibmcloud ce app unbind --name APP_NAME --all
   

   마찬가지로, 작업을 사용하는 경우에는 ibmcloud ce job unbind --name JOB_NAME --all 명령을 실행하여 작업에 대한 모든 서비스 인스턴스를 바인딩 해제하십시오.

3. 바인딩을 새로 작성하십시오. 바인딩을 새로 작성하려면 ibmcloud ce app bind 또는 ibmcloud ce job bind 명령을 실행하십시오. 이전 구현을 사용하는 서비스 바인딩을 대체하려면 app get 또는 job get 명령의 출력에 제공된 명령을 사용하십시오. 예를 들어, Code Engine 애플리케이션 myapp에서 IBM Cloud Object Storage 서비스 인스턴스 myobjectstorage로의 기존 바인딩을 다시 작성하려면 다음 명령을 사용하십시오.

   ibmcloud ce app bind --name myapp --service-instance myobjectstorage --prefix CLOUD_OBJECT_STORAGE
   

   마찬가지로, 작업을 사용하는 경우에는 ibmcloud ce job bind --name JOB_NAME ---service-instance SERVICE_INSTANCE --prefix PREFIX 명령을 실행하십시오.

   다시 작성할 각 바인딩에 대해 이 단계를 반복하십시오.

4. (선택사항) app get 또는 job get 명령을 다시 실행하십시오. 이번에는 이전 구현의 서비스 바인딩에 대한 정보가 명령 출력에 표시되지 않습니다. 예를 들면 다음과 같습니다.

   ibmcloud ce app get --name myapp
   

   출력 예

   Run 'ibmcloud ce application events -n myapp' to get the system events of the application instances.
   Run 'ibmcloud ce application logs -f -n myapp' to follow the logs of the application instances.
   OK
   Name:               myapp
   ID:                 abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
   Project Name:       myproject
   Project ID:         01234567-abcd-abcd-abcd-abcdabcd1111
   Age:                2m4s
   Created:            2021-09-09T14:01:02-04:00
   URL:                https://myapp.abcdabcdabc.us-south.codeengine.appdomain.cloud
   Cluster Local URL:  http://myapp.abcdabcdabc.svc.cluster.local
   Console URL:        https://cloud.ibm.com/codeengine/project/us-south/01234567-abcd-abcd-abcd-abcdabcd1111/application/myapp/configuration
   Status Summary:     Application deployed successfully
   [...]
   Service Bindings:
   Name                                         ID                                    Service Instance      Service Type          Role / Credential  Environment Variable Prefix
   myapp-app-ce-service-binding-abcde          abcde5d3-dfc3-4f52-b133-b869b5eabcde   my-object-storage    cloud-object-storage   Writer             CLOUD_OBJECT_STORAGE