조직, 환경, 가상 호스트 만들기

Private Cloud용 Edge v4.19.01

명령줄에서 조직, 환경, 가상 호스트를 명령어를 사용하거나 각각 별도로 만들 수 있습니다. 또한 관리 API 수행할 수 있습니다

동영상: Apigee 조직 설정 및 구성의 개요를 소개하는 짧은 동영상을 시청하세요.

조직을 만들고, 가상 호스트를 통해 배포되며

Apigee Edge에서 API 프록시를 만들려면 먼저 조직을 하나 이상 만들어야 합니다. 하나 이상의 환경 및 가상 호스트에서 식별할 수 있습니다.

일반적으로 조직과 환경은 함께 생성됩니다. 프로세스를 간소화하려면 apigee-provision 유틸리티입니다. 에지 관리의 명령줄에서 호출 서버:

/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

여기서 configFile는 다음과 유사한 구성 파일의 경로입니다. 있습니다.

# Set Edge sys admin credentials.
ADMIN_EMAIL=your@email.com
APIGEE_ADMINPW=admin_password  # If omitted, you are prompted for it.
NEW_USER="y"
USER_NAME=orgAdmin@myCo.com
FIRST_NAME=foo
LAST_NAME=bar
USER_PWD="userPword"
ORG_NAME=example  # lowercase only, no spaces, underscores, or periods.
ENV_NAME=prod  # lowercase only
VHOST_PORT=9001
VHOST_NAME=default
VHOST_ALIAS="$IP1:9001"
# Optionally configure TLS/SSL for virtual host.
# VHOST_SSL=y     # Set to "y" to enable TLS/SSL on the virtual host.
# KEYSTORE_JAR=   # JAR file containing the cert and private key.
# KEYSTORE_NAME=  # Name of the keystore.
# KEYSTORE_ALIAS= # The key alias.
# KEY_PASSWORD=   # The key password, if it has one.
# Optionally set the base URL displayed by the Edge UI for an
# API proxy deployed to the virtual host.
# VHOST_BASEURL="http://myCo.com"
# AXGROUP=axgroup-001 # Default value is axgroup-001

조직을 설정할 때 setup-org 스크립트는 다음을 수행합니다.

  • 조직을 만듭니다.
  • 조직을 '게이트웨이'에 연결 포드를 선택합니다 변경할 수 없습니다.
  • 지정된 사용자를 조직 관리자로 추가합니다. 사용자가 존재하지 않는 경우 만들 수 있습니다
  • 하나 이상의 환경을 만듭니다.
  • 각 환경에 하나 이상의 가상 호스트를 만듭니다.
  • 환경을 모든 메시지 프로세서와 연결합니다.
  • 분석을 사용 설정합니다.

기본적으로 조직 이름과 환경 이름의 최대 길이는 20자(영문 기준)입니다. apigee-provision 유틸리티를 사용하는 경우 이 한도는 Edge API를 직접 사용하여 조직 또는 환경을 만듭니다. 조직 이름 및 환경 모두 이름은 소문자여야 합니다.

조직 만들기

다음 예시와 같이 create-org 명령어를 사용하여 조직을 만듭니다. 표시:

/opt/apigee/apigee-service/bin/apigee-service apigee-provision create-org -f configFile

이 스크립트는 조직을 생성하지만 환경을 추가하거나 구성하지는 않으며 조직에서 API 호출을 처리하는 데 필요한 가상 호스트

구성 파일에는 조직의 이름과 조직의 이메일 주소가 포함되어 있습니다. 관리 액세스 name 속성에서 사용할 수 있는 문자는 a-z0-9\-$% 이름에 공백, 마침표 또는 대문자를 사용하지 마세요.

APIGEE_ADMINPW=admin_password    # If omitted, you are prompted for it.
ORG_NAME=example  # lowercase only, no spaces, underscores, or periods.
ORG_ADMIN=orgAdmin@myCo.com

create-org 스크립트:

  • 조직을 만듭니다.
  • 조직을 '게이트웨이'에 연결 포드를 선택합니다
  • 지정된 사용자를 조직 관리자로 추가합니다. 사용자가 이미 존재해야 합니다. 그렇지 않으면 스크립트에서 오류가 발생합니다.
를 통해 개인정보처리방침을 정의할 수 있습니다.

다음을 사용하여 조직 만들기 API 호출

다음 API 호출을 사용하여 조직을 만들 수 있습니다. 첫 번째 호출은 조직:

curl -H "Content-Type:application/xml" -u sysAdminEmail:adminPasswd \
  -X POST http://management_server_IP:8080/v1/organizations \
  -d '<Organization name="org_name" type="paid"/>'

다음 호출은 조직을 포드와 연결합니다.

curl -H "Content-Type:application/x-www-form-urlencoded" \
  -u sysAdminEmail:adminPasswd -X POST \
  http://management_server_IP:8080/v1/organizations/org_name/pods \
  -d "region=default&pod=gateway"

마지막 호출에서는 기존 사용자를 조직의 조직 관리자로 추가합니다.

curl -H "Content-Type:application/xml" -u sysAdminEmail:adminPasswd \
  -X POST http://<ms-ip>:8080/v1/organizations/org_name/users/user_email/userroles/ \
  -d '<Roles><Role name="orgadmin"/></Roles>'
<ph type="x-smartling-placeholder">

사용자가 존재하지 않는 경우 다음 호출을 사용하여 다음에 설명된 대로 사용자를 만들 수 있습니다. 사용자 추가.

환경 만들기

add-env 스크립트를 사용하여 기존 조직에 환경을 만듭니다.

/opt/apigee/apigee-service/bin/apigee-service apigee-provision add-env -f configFile

이 구성 파일에는 환경 및 가상 머신을 만드는 데 필요한 정보가 포함되어 있습니다. 호스트:

APIGEE_ADMINPW=admin_password  # If omitted, you are prompted for it.
ORG_NAME=example  # lowercase only, no spaces, underscores, or periods.
ENV_NAME=prod  # lowercase only
VHOST_PORT=9001
VHOST_NAME=default
VHOST_ALIAS="$IP1:9001"
# Optionally configure TLS/SSL for virtual host.
# VHOST_SSL=y     # Set to "y" to enable TLS/SSL on the virtual host.
# KEYSTORE_JAR=   # JAR file containing the cert and private key.
# KEYSTORE_NAME=  # Name of the keystore. 
# KEYSTORE_ALIAS= # The key alias.
# KEY_PASSWORD=   # The key password, if it has one. 
# Optionally set the base URL displayed by the Edge UI for an
# API proxy deployed to the virtual host.
# VHOST_BASEURL="http://myCo.com"
# AXGROUP=axgroup-001 # Default value is axgroup-001

add-env 명령어:

  • 환경을 만듭니다.
  • 환경에 대한 단일 가상 호스트를 만듭니다.
  • 환경을 kube-apiserver와 통신하는 역할을 합니다
  • 분석 지원

다음을 사용하여 환경을 만듭니다. API 호출

또는 다음 API 호출을 사용하여 환경을 만들 수 있습니다. 첫 번째 호출 환경을 만듭니다.

curl -H "Content-Type:application/xml" -u sysAdminEmail:adminPasswd \
  -X POST http://management_server_IP:8080/v1/organizations/org_name/environments \
  -d '<Environment name="env_name"/>'

다음 호출은 환경을 메시지 프로세서와 연결합니다. 각각에 대해 이 통화 환경과 연결할 메시지 프로세서:

curl -H "Content-Type:application/x-www-form-urlencoded" \
  -u sysAdminEmail:adminPasswd -X POST \
  http://management_server_IP:8080/v1/organizations/org_name/environments/env_name/servers \
  -d "action=add&uuid=uuid"

여기서 uuid는 메시지 프로세서의 UUID입니다. 다음 명령어로 UUID를 가져올 수 있습니다. 명령어:

curl http://Message_Processor_IP:8082/v1/servers/self

여기서 Message_Processor_IP는 메시지 프로세서의 IP 주소입니다.

다음 API 호출은 지정된 환경에서 애널리틱스를 사용 설정합니다. 이 검증은 모든 데이터 센터의 POD에 있는 Qpid 및 Postgres 서버 그런 다음 애널리틱스 온보딩을 시작합니다. 책임감 있는 AI를 구현할 수 있습니다

이 구성 파일에는 다음이 포함됩니다.

ORG_NAME=orgName  # lowercase only, no spaces, underscores, or periods.
ENV_NAME=envName  # lowercase only

여기서 sample.json에는 다음이 포함되어 있습니다.

{
  "properties" : {
    "samplingAlgo" : "reservoir_sampler",
    "samplingTables" : "10=ten;1=one;",
    "aggregationinterval" : "300000",
    "samplingInterval" : "300000",
    "useSampling" : "100",
    "samplingThreshold" : "100000"
  },
  "servers" : {
    "postgres-server" : [ "1acff3a5-8a6a-4097-8d26-d0886853239c", "f93367f7-edc8-4d55-92c1-2fba61ccc4ab" ],  
    "qpid-server" : [ "d3c5acf0-f88a-478e-948d-6f3094f12e3b", "74f67bf2-86b2-44b7-a3d9-41ff117475dd"] 
  }
}

postgres-servers 속성 에는 쉼표로 구분된 Postgres UUID 목록이 포함되며 qpid-server 속성에는 Qpid UUID가 포함됩니다. 이러한 UUID를 가져와야 하는 경우 다음 명령어를 사용합니다.

Qpid의 경우 다음 명령어를 실행합니다.

curl -u sysAdminEmail:password http://management_server_IP/v1/servers?pod=central

이 명령어의 출력은 JSON 객체입니다. 각 Qpid 서버에 대한 출력은 양식:

"type" : [ "qpid-server" ],
"uUID" : "d3c5acf0-f88a-478e-948d-6f3094f12e3b"

Postgres의 경우 다음 명령어를 실행합니다.

curl -u sysAdminEmail:admin_password http://management_server_IP/v1/servers?pod=analytics

각 Postgres 서버에 대해 다음 형식으로 출력이 표시됩니다.

"type" : [ "postgres-server" ],
"uUID" : "d3c5acf0-f88a-478e-948d-6f3094f12e3b"

가상 호스트 만들기

조직의 기존 환경에서 가상 호스트를 만들 수 있습니다. 보통 여러 가상 호스트를 지원합니다 예를 들어 하나의 가상 호스트는 동일한 환경의 다른 가상 호스트는 암호화된 HTTPS를 지원합니다. 사용할 수 있습니다

다음 API 호출을 사용하여 추가 가상 호스트를 만들거나 가상 호스트가 없는 환경인 경우:

curl -H "Content-Type:application/xml" -u sysAdminEmail:adminPasswd \
  -X POST http://management_server_IP:8080/v1/organizations/org_name/environments/env_name/virtualhosts \
  -d '<VirtualHost name="default"> \
    <HostAliases> \
      <HostAlias>myorg-test.apigee.net</HostAlias> \
    </HostAliases> \
    <Interfaces/> \
    <Port>443</Port> \
  </VirtualHost>'

보안 가상 호스트 생성을 포함하여 가상 호스트 만들기에 대한 자세한 설명 TLS를 통해 TLS/SSL을 사용하는 호스트에 대한 자세한 내용은 API에 대한 TLS 액세스 구성 (Private Cloud용)