Skip to content

cli.md

Latest commit

 

History

History
167 lines (113 loc) · 3.67 KB

cli.md

File metadata and controls

167 lines (113 loc) · 3.67 KB

CLI

The any-sdk CLI is for testing purposes, so long as semver < 1.

Build

From the root of this repository:

cicd/cli/build_cli.sh

This creates an executable at the .gitignored location build/anysdk.

Examples

Const

The const command is very much a trivial "Hello World":

./build/anysdk const

This returns:

{"ExtensionKeyAlwaysRequired":"x-alwaysRequired"}

Query

HTTP Provider:

export GOOGLE_CREDENTIALS="$(cat cicd/keys/google-ro-credentials.json)"


./build/anysdk query \
  --svc-file-path="test/tmp/googleapis.com/v24.11.00274/services/compute.yaml" \
  --prov-file-path="test/tmp/googleapis.com/v24.11.00274/provider.yaml" \
  --resource accelerator_types \
  --method aggregated_list \
  --parameters '{ "project": "stackql-demo" }' \
  | jq -r '.items["zones/us-east7-b"]'


./build/anysdk query \
  --svc-file-path="test/tmp/googleapis.com/v24.11.00274/services/storage.yaml" \
  --prov-file-path="test/tmp/googleapis.com/v24.11.00274/provider.yaml" \
  --resource buckets \
  --method list \
  --parameters '{ "project": "stackql-demo" }' \
  | jq -r '.items[].id'

Local templated provider mutation:

./build/anysdk query \
  --svc-file-path="test/registry/src/local_openssl/v0.1.0/services/keys.yaml" \
  --prov-file-path="test/registry/src/local_openssl/v0.1.0/provider.yaml" \
  --resource rsa \
  --method create_key_pair \
  --parameters '{ 
			"config_file":   "test/openssl/openssl.cnf",
			"key_out_file":  "test/tmp/key.pem",
			"cert_out_file": "test/tmp/cert.pem",
			"days":          90
		}'

Local templated provider selection:

./build/anysdk query \
  --svc-file-path="test/registry/src/local_openssl/v0.1.0/services/keys.yaml" \
  --prov-file-path="test/registry/src/local_openssl/v0.1.0/provider.yaml" \
  --resource x509 \
  --method describe_certificate \
  --parameters '{
			"cert_file": "test/tmp/cert.pem"
		}'

For xml response trasformation on HTTP services...

In this aws.ec2 example, you will first need to export your aws credential env vars AWS_SECRET_ACCESS_KEY and AWS_ACCESS_KEY_ID and then this gives a nice json response:

build/anysdk query \
  --svc-file-path="test/registry/src/aws/v0.1.0/services/ec2.yaml" \
  --tls.allowInsecure \
  --prov-file-path="test/registry/src/aws/v0.1.0/provider.yaml" \
  --resource volumes_presented \
  --method describeVolumes \
  --parameters '{ "region": "ap-southeast-2" }'

This one incorporates the hack for request translation:

build/anysdk query \
  --svc-file-path="test/registry-simple/src/aws/v0.1.0/services/ec2.yaml" \
  --tls.allowInsecure \
  --prov-file-path="test/registry-simple/src/aws/v0.1.0/provider.yaml" \
  --resource volumes_presented \
  --method describeVolumes \
  --parameters '{ "region": "ap-southeast-2" }'

EC2 cod dev:

build/anysdk query \
  --svc-file-path="test/registry-simple/src/aws/v0.1.0/services/ec2.yaml" \
  --tls.allowInsecure \
  --prov-file-path="test/registry-simple/src/aws/v0.1.0/provider.yaml" \
  --resource volumes_presented \
  --method describeVolumes \
  --parameters '{ "region": "ap-southeast-2" }'

S3 one of the great challenges:

build/anysdk query \
  --svc-file-path="test/registry-simple/src/aws/v0.1.0/services/s3.yaml" \
  --tls.allowInsecure \
  --prov-file-path="test/registry-simple/src/aws/v0.1.0/provider.yaml" \
  --resource bucket_abac \
  --method get_bucket_abac \
  --parameters '{ "region": "ap-southeast-1", "Bucket": "stackql-trial-bucket-01" }'

AOT analysis

build/anysdk aot \
  ./test/registry \
  ./test/registry/src/aws/v0.1.0/provider.yaml \
  -v \
  --schema-dir \
  cicd/schema-definitions