红帽全球峰会此内容没有您所选择的语言版本。
Chapter 1. Using the toolbox
The 3scale toolbox is a Ruby client that lets you manage 3scale services from the command line.
1.1. Installing the toolbox
The only officially supported method of installing the toolbox is on Red Hat Enterprise Linux using yum or rpm.
You need the following prerequisites:
Access to the
rhel-7-server-3scale-amp-2.4-rpmsrepository.Add it by running:
subscription-manager repos --enable=rhel-7-server-3scale-amp-2.4-rpms
subscription-manager repos --enable=rhel-7-server-3scale-amp-2.4-rpmsCopy to Clipboard Copied! Toggle word wrap Toggle overflow Access to the
rhel-server-rhscl-7-rpmsrepository.Add it by running:
sudo yum-config-manager --enable rhel-server-rhscl-7-rpms
sudo yum-config-manager --enable rhel-server-rhscl-7-rpmsCopy to Clipboard Copied! Toggle word wrap Toggle overflow
Then install the toolbox:
yum install 3scale_toolbox
$ yum install 3scale_toolbox
You can however use unsupported versions on Fedora Linux, Ubuntu Linux, Windows and macOS by downloading and installing the .rpm, .deb, .msi or .pkg file directly from GitHub.
1.2. Importing services
Import services from a CSV file by specifying the following fields in this order (you also need to include these headers in your CSV file):
service_name,endpoint_name,endpoint_http_method,endpoint_path,auth_mode,endpoint_system_name,type
service_name,endpoint_name,endpoint_http_method,endpoint_path,auth_mode,endpoint_system_name,typeYou’ll need the following information:
-
3scale admin account:
{3SCALE_ADMIN} -
domain your 3scale instance is running on:
{DOMAIN_NAME}(if you’re using hosted APICast this is 3scale.net) -
access key of your account:
{ACCESS_KEY} -
CSV file of services (
examples/import_example.csv)
Import the services by running:
3scale import csv --destination=https://{ACCESS_KEY}@{3SCALE_ADMIN}-admin.{DOMAIN_NAME} --file=examples/import_example.csv
$ 3scale import csv --destination=https://{ACCESS_KEY}@{3SCALE_ADMIN}-admin.{DOMAIN_NAME} --file=examples/import_example.csv1.3. Copying services
Create a new service based on an existing one from the same SaaS account or from another account.
You’ll need the following information:
-
service id you want to copy:
{SERVICE_ID} -
3scale admin account:
{3SCALE_ADMIN} -
domain your 3scale instance is running on:
{DOMAIN_NAME}(if you’re using hosted APICast this is 3scale.net) -
access key of your account:
{ACCESS_KEY} -
access key of the destination account if you’re copying to a different account:
{DEST_KEY} -
name for the new service:
{NEW_NAME}
3scale copy service {SERVICE_ID} --source=https://{ACCESS_KEY}@{3SCALE_ADMIN}-admin.{DOMAIN_NAME} --destination=https://{DEST_KEY}@{3SCALE_ADMIN}-admin.{DOMAIN_NAME} --target_system_name={NEW_NAME}
$ 3scale copy service {SERVICE_ID} --source=https://{ACCESS_KEY}@{3SCALE_ADMIN}-admin.{DOMAIN_NAME} --destination=https://{DEST_KEY}@{3SCALE_ADMIN}-admin.{DOMAIN_NAME} --target_system_name={NEW_NAME}1.4. Copying service settings only
Bulk copy (also known as updating) the service settings, proxy settings, metrics, methods, application plans, application plan limits and mapping rules from one service to another which already exists.
You’ll need the following information:
-
service id you want to copy:
{SERVICE_ID} -
service id of the destination:
{DEST_ID} -
3scale admin account:
{3SCALE_ADMIN} -
domain your 3scale instance is running on:
{DOMAIN_NAME}(if you’re using hosted APICast this is 3scale.net) -
access key of your account:
{ACCESS_KEY} -
access key of the destination account:
{DEST_KEY}
And can use the following optional flags:
-
-fremove existing target service mapping rules before copying -
-rcopy only mapping rules to target service
3scale update [opts] service --source=https://{ACCESS_KEY}@{3SCALE_ADMIN}-admin.{DOMAIN_NAME} --destination=https://{DEST_KEY}@{3SCALE_ADMIN}-admin.{DOMAIN_NAME} {SERVICE_ID} {DEST_ID}
$ 3scale update [opts] service --source=https://{ACCESS_KEY}@{3SCALE_ADMIN}-admin.{DOMAIN_NAME} --destination=https://{DEST_KEY}@{3SCALE_ADMIN}-admin.{DOMAIN_NAME} {SERVICE_ID} {DEST_ID}1.5. Troubleshooting SSL issues
There is more information on certificates in the Red Hat documentation, but if you’re getting issues related to self-signed SSL certificates, SSL certificate problem: self signed certificate for example , you can download and use the remote certificate:
Download the remote certificate using
opensslecho | openssl s_client -showcerts -servername self-signed.badssl.com -connect self-signed.badssl.com:443 2>/dev/null | sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' > self-signed-cert.pem
$ echo | openssl s_client -showcerts -servername self-signed.badssl.com -connect self-signed.badssl.com:443 2>/dev/null | sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' > self-signed-cert.pemCopy to Clipboard Copied! Toggle word wrap Toggle overflow Make sure it works by using it with
curlSSL_CERT_FILE=self-signed-cert.pem curl -v https://self-signed.badssl.com
$ SSL_CERT_FILE=self-signed-cert.pem curl -v https://self-signed.badssl.comCopy to Clipboard Copied! Toggle word wrap Toggle overflow If the certificate is working properly, you won’t get the SSL error.
Prefix your
3scalecommands withSSL_CERT_FILE=self-signed-cert.pem:SSL_CERT_FILE=self-signed-cert.pem 3scale import csv
$ SSL_CERT_FILE=self-signed-cert.pem 3scale import csvCopy to Clipboard Copied! Toggle word wrap Toggle overflow
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}