명령줄에서 조직, 환경, 가상 호스트를 명령어를 사용하거나 각각 별도로 만들 수 있습니다. 또한 Edge 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>'
사용자가 없는 경우 다음 호출을 사용하여 다음에 설명된 대로 사용자를 만들 수 있습니다. 사용자 추가.
환경 만들기
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용)