Edge Microgateway-এর জন্য Docker ব্যবহার করা

আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন দেখুন। তথ্য

এই বিষয়ে Docker কন্টেনারে Edge Microgateway কীভাবে রান করাতে হয় তা ব্যাখ্যা করা হয়েছে। এই বিষয়ে আলোচিত ধাপগুলি Docker, Docker কমান্ড এবং Edge Microgateway সেট-আপ ও কনফিগারেশন সম্পর্কে প্রাথমিক জ্ঞান আছে বলে ধরে নেয়। আরও তথ্যের জন্য, Docker ও Edge Microgateway-এর ডকুমেন্টেশন দেখুন।

পূর্বশর্ত

Docker কন্টেনারে Edge Microgateway চালানোর আগে, আপনাকে অবশ্যই নিম্নলিখিত কাজগুলি করতে হবে:

  • আপনার Apigee সংস্থা/পরিবেশের জন্য Edge Microgateway কনফিগার করুন:

    edgemicro configure -o your_org -e your_env -u your_username

    কনফিগারেশন সম্পর্কে আরও বিবরণের জন্য, পার্ট ১: Edge Microgateway কনফিগার করুন দেখুন।

  • কনফিগারেশন ধাপগুলি সম্পূর্ণ করার পরে, কনফিগারেশন ফাইলটি খুঁজে নিন। ডিফল্ট লোকেশন এখানে দেওয়া হল:

    $HOME/.edgemicro/your_org-your_env-config.yaml

    যেখানে your_org ও your_env হল সেইসব সংস্থা ও পরিবেশ যা আপনি edgemicro config কমান্ড চালানোর সময় ব্যবহার করেছেন। Docker কন্টেনারে Edge Microgateway চালু করার সময় এই ফাইলটি আপনার প্রয়োজন হবে।

  • আপনি যে কী ও গোপন ক্রেডেনশিয়াল পেয়েছেন তা নিশ্চিত করুন, এগুলি edgemicro config কমান্ড চালানোর সময় ফেরত দেওয়া হয়েছে। যেমন:

    The following credentials are required to start edge micro
  key: d9c34e1aff68ed969273c016699eabf48780e4f652242e72fc88a43e21252cb0
  secret: 3bc95a71c86a3c8ce04537fbcb788158731t51dfc6cdec13b7c05aa0bd969430

  • Docker কন্টেনারে Edge Microgateway শুরু করার আগে, আপনাকে Apigee Edge এন্টিটি তৈরি করতে হবে (বা তৈরি করা থাকতে হবে) যা প্রমাণিত API প্রক্সি কল করার জন্য প্রয়োজন। এইসব এনটিটির মধ্যে Edge Microgateway-সচেতন প্রক্সি, API প্রোডাক্ট, ডেভেলপার ও ডেভেলপার অ্যাপ অন্তর্ভুক্ত। সম্পূর্ণ নির্দেশাবলীর জন্য, Apigee Edge-এ এনটিটি তৈরি করুন দেখুন।

Docker কন্টেনার হিসেবে Edge Micro চালানো

  1. Edge Microgateway-এর জন্য Docker ইমেজ ডাউনলোড করুন:

    docker pull gcr.io/apigee-microgateway/edgemicro:latest

  2. পরবর্তী ধাপে যাওয়ার আগে, পূর্বশর্ত বিভাগে উল্লেখ করা সব ধাপ আপনি সম্পূর্ণ করেছেন কিনা তা নিশ্চিত করুন।

  3. $HOME/.edgemicro-এ থাকা Edge Microgateway কনফিগারেশন ফাইলকে base64-এনকোড করতে নিম্নলিখিত কমান্ডটি রান করুন:

    export EDGEMICRO_CONFIG=`base64 $HOME/.edgemicro/your_org-your_env-config.yaml`

    যেখানে your_org ও your_env হল সেইসব সংস্থা ও এনভায়র্নমেন্ট যা আপনি edgemicro config কমান্ড চালানোর সময় ব্যবহার করেছেন।

    কমান্ডের চারপাশে ব্যাক-টিক (`) দিতে ভুলবেন না। যেমন:

    export EDGEMICRO_CONFIG=`base64 $HOME/.edgemicro/docs-test-config.yaml`

  4. কন্টেনার হিসেবে Edge Microgateway চালান। এই কমান্ডটি বেশ কিছু এনভায়রনমেন্ট ভেরিয়েবল সেট করে যা Edge Microgateway চালু করার জন্য কন্টেনার রানটাইম ব্যবহার করে:

    docker run -P -p 8000:8000 -d --name edgemicro \
-v /var/tmp:/opt/apigee/logs \
-e EDGEMICRO_PROCESSES=1 \
-e EDGEMICRO_ORG=your_org \
-e EDGEMICRO_ENV=your_env \
-e EDGEMICRO_KEY=your_key \
-e EDGEMICRO_SECRET=your_secret \
-e "EDGEMICRO_CONFIG=$EDGEMICRO_CONFIG" \
-e SERVICE_NAME=edgemicro \
--security-opt=no-new-privileges \
--cap-drop=ALL \
gcr.io/apigee-microgateway/edgemicro:latest

    প্যারামিটার

    প্যারামিটার বিবরণ
    -P হোস্টের কাছে সব এক্সপোজ করা পোর্ট প্রকাশ করুন। এছাড়াও, Docker রান রেফারেন্স দেখুন।
    -p একটি পোর্ট বা পোর্ট রেঞ্জ স্পষ্টভাবে ম্যাপ করুন। এছাড়াও, Docker রান রেফারেন্স দেখুন।
    -d ডিটাচড মোডে রান করুন। এছাড়াও, Docker রান রেফারেন্স দেখুন।
    -v, --volume ভলিউম মাউন্ট নির্দিষ্ট করে। মনে রাখবেন, আপনি যদি Docker কন্টেনারে TLS ব্যবহার করার জন্য Edge Microgateway কনফিগার করেন, তাহলে আপনাকে অবশ্যই পোর্ট ৮৪৪৩ এক্সপোজ করতে হবে যদি আপনি লগ ফাইল ডিরেক্টরি মাউন্ট করেন। এছাড়াও VOLUME [shared filesystems] দেখুন। এছাড়াও Docker কন্টেনারে TLS ব্যবহার করা দেখুন।
    EDGEMICRO_ORG Edge Microgateway কনফিগার করার জন্য আপনি যে Apigee সংস্থার নাম ব্যবহার করেছেন।
    EDGEMICRO_ENV Edge Microgateway কনফিগার করার জন্য আপনি যে Apigee এনভায়রনমেন্ট ব্যবহার করেছেন তার নাম।
    EDGEMICRO_PROCESSES শুরু করার জন্য প্রসেসের সংখ্যা।
    EDGEMICRO_KEY আপনি Edge Microgateway কনফিগার করার সময় কীটি ফেরত দেওয়া হয়।
    EDGEMICRO_SECRET আপনি Edge Microgateway কনফিগার করার সময় যে সিক্রেটটি ফেরত পেয়েছেন।
    EDGEMICRO_CONFIG Base64-এনকোড করা Edge Microgateway কনফিগারেশন ফাইল সহ একটি ভেরিয়েবল।
    SERVICE_NAME আপনি Kubernetes-এ থাকলে, এই প্যারামিটার অটোমেটিক পূরণ হয়ে যাবে। অন্যথায়, আপনি এটি নিজের ইচ্ছামতো যেকোনও কিছুতে সেট করতে পারবেন। আপনি কিছু উল্লেখ না করলে, পরিষেবার নাম default হিসেবে সেট করা হয়।
    DEBUG ডিবাগিং চালু করতে * হিসেবে সেট করুন।
    HTTP_PROXY HTTPS_PROXY Edge Microgateway ফায়ারওয়ালের পিছনে রান করলে এবং গেটওয়ে Apigee Edge-এর সাথে যোগাযোগ করতে না পারলে এটি ব্যবহার করুন। আরও তথ্যের জন্য, কোনও কোম্পানির ফায়ারওয়ালের পিছনে Edge Microgateway সেট-আপ করা দেখুন।

    যেমন: HTTP_PROXY=http://10.203.0.1:5187/
    NO_PROXY Edge Microgateway-কে প্রক্সি করতে হবে না এমন ডোমেনের কমা-বিচ্ছিন্ন তালিকা। আরও তথ্যের জন্য, কোনও কোম্পানির ফায়ারওয়ালের পিছনে Edge Microgateway সেট-আপ করা দেখুন।

    যেমন: localhost,127.0.0.1,localaddress,.localdomain.com
    NODE_EXTRA_CA_CERTS (ঐচ্ছিক) আপনি যদি এমন কোনও CA ব্যবহার করেন যা Node.js-এর দ্বারা ডিফল্ট হিসেবে বিশ্বাসযোগ্য নয়, তাহলে এই প্যারামিটার ব্যবহার করুন। এই প্যারামিটারের ভ্যালু এমন একটি ফাইলের পাথ হিসেবে সেট করুন যেটিতে PEM ফর্ম্যাটে এক বা একাধিক বিশ্বস্ত সার্টিফিকেট আছে। আরও জানতে, TLS সার্টিফিকেট দেখুন।
    --security-opt (ঐচ্ছিক) পছন্দসই Docker নিরাপত্তা বিকল্প সেট করে। Docker ডকুমেন্টেশনে সুরক্ষা কনফিগারেশন দেখুন।
    --cap-drop (ঐচ্ছিক) কন্টেনারে অনুমোদিত Linux ক্ষমতার উপর সীমা সেট করে। Docker ডকুমেন্টেশনে রানটাইম প্রিভিলেজ ও Linux ক্যাপাবিলিটি দেখুন।

    যেমন:

    docker run -P -p 8000:8000 -d --name edgemicro \
-v /var/tmp:/opt/apigee/logs \
-e EDGEMICRO_PROCESS=1 \
-e EDGEMICRO_ORG=docs \
-e EDGEMICRO_ENV=test \
-e EDGEMICRO_KEY=d9c34e1aff68ed969273b016699eabf48780e4f652242e72fc88a23e21252cb0 \
-e EDGEMICRO_SECRET=3bc95a71c86a3c8ce04137fbcb788158731t51dfc6cdec13b7c05aa0bd969430 \
-e "EDGEMICRO_CONFIG=$EDGEMICRO_CONFIG" \
-e SERVICE_NAME=edgemicro \
--security-opt=no-new-privileges \
--cap-drop=ALL \
gcr.io/apigee-microgateway/edgemicro

  5. কন্টেনার চলছে কিনা তা চেক করতে:

    docker ps

    আপনি নিম্নলিখিত আউটপুটের মতো আউটপুট দেখতে পাবেন:

    CONTAINER ID    IMAGE         COMMAND                CREATED          STATUS          PORTS                                             NAMES
8b92e082ea9c    edgemicro    "/tmp/entrypoint.sh"   12 minutes ago   Up 12 minutes    0.0.0.0:8000->8000/tcp, 0.0.0.0:32775->8443/tcp    edgemicro

API কল পরীক্ষা করা

কন্টেনারে Edge Microgateway চালু করার পরে, আপনি এতে API কল করতে পারবেন। যেমন, আপনার API-এর বেসপাথ /hello হলে:

http://localhost:8000/hello

স্যাম্পেল আউটপুট:

{"error":"missing_authorization","error_description":"Missing Authorization header"}

আপনি এই উত্তরটি দেখলে, এর অর্থ হল Edge Microgateway API কলটি সফলভাবে হ্যান্ডেল করেছে। তবে, ডিফল্ট হিসেবে, যাচাইকরণের জন্য Edge Microgateway-এর API কী প্রয়োজন। পরের বিভাগে, আপনি একটি সঠিক API কী দিয়ে API পরীক্ষা করবেন।

সঠিক API key দিয়ে API পরীক্ষা করা

Edge UI-তে, আপনার আগে তৈরি করা ডেভেলপার অ্যাপে নেভিগেট করুন। Developer অ্যাপ পৃষ্ঠায়, কনজিউমার কী দেখুন এবং এটি কপি করুন। এই ভ্যালুটি হল API key. যাচাই করা API কল করার জন্য এই কী ব্যবহার করবেন।

নিচে দেখানো x-api-key হেডার সহ API কল করুন। আপনি ডেভেলপার অ্যাপ থেকে যে কনজিউমার কী ভ্যালু কপি করেছেন সেটিই হল API কী। ডিফল্ট হিসেবে, Edge Microgateway আপনাকে x-api-key নামের একটি হেডারে কী পাস করতে হবে বলে ধরে নেয়, যেমন:

curl -i http://localhost:8000/hello -H "x-api-key:apikey"

যেমন:

curl -i http://localhost:8000/hello -H "x-api-key:PydUKRDGIXRqF2xh4usn1FLHbhGKVIz"

আপনি যদি API কী এবং OAuth টোকেনের মাধ্যমে Edge Microgateway ব্যবহার করে যাচাই করা API কল করা সম্পর্কে আরও জানতে চান, তাহলে পার্ট ৪: সুরক্ষিত Edge Microgateway দেখুন।

Edge Microgateway বন্ধ করা

Edge Microgateway বন্ধ করতে নিম্নলিখিত Docker কমান্ড ব্যবহার করুন:

docker stop edgemicro

Edge Microgateway রিস্টার্ট করা

Edge Microgateway বন্ধ করার পরে, আপনি এই Docker কমান্ডের মাধ্যমে এটি রিস্টার্ট করতে পারবেন:

docker start edgemicro

Docker কন্টেনারে TLS ব্যবহার করা

এই বিভাগে, Docker কন্টেনারে চলমান Edge Microgateway-এর জন্য কীভাবে TLS কনফিগার করতে হয় তা ব্যাখ্যা করা হয়েছে। আপনি Edge Microgateway সার্ভারকে ইনকামিং অনুরোধের (উত্তরমুখী দিক) জন্য TLS ব্যবহার করার জন্য কনফিগার করতে পারেন এবং আপনি Edge Microgateway-কে টার্গেট এন্ডপয়েন্টে আউটগোয়িং অনুরোধের (দক্ষিণমুখী দিক) জন্য TLS ক্লায়েন্ট হিসেবে কনফিগার করতে পারেন।

সার্টিফিকেট ফাইল কোথায় রাখতে হবে

Edge Microgateway রান করা Docker কন্টেনারে /opt/apigee/.edgemicro-এ মাউন্ট পয়েন্ট আছে। TLS সার্টিফিকেট ব্যবহার করার জন্য Edge Microgateway কনফিগার করলে, আপনি সেই মাউন্ট পয়েন্টে সার্টিফিকেট ফাইল উপলভ্য করতে এবং Edge Microgateway কনফিগারেশন ফাইলে সেগুলি উল্লেখ করতে পারবেন। এই কনফিগারেশন ফাইলটি সাধারণত $HOME/.edgemicro ডিরেক্টরিতে থাকে এবং এর নাম your_org-your_env-config.yaml। যেমন:

...
edgemicro:
  ssl:
   key: /opt/apigee/.edgemicro/southbound/tls.key
   cert: /opt/apigee/.edgemicro/southbound/tls.crt
...

Node.js-এর বিশ্বাসযোগ্য নয় এমন CA ব্যবহার করা

আপনি যদি এমন কোনও সার্টিফিকেট অথরিটি (CA) ব্যবহার করেন যা ডিফল্ট হিসেবে Node.js বিশ্বাস করে না (যেমন, সেল্ফ-সাইন করা সার্টিফিকেটের ক্ষেত্রে হয়), তাহলে কন্টেনার চালানোর সময় NODE_EXTRA_CA_CERTS প্যারামিটার ব্যবহার করার কথা বিবেচনা করুন।

PEM ফর্ম্যাটে এক বা একাধিক বিশ্বস্ত সার্টিফিকেট আছে এমন ফাইলের পাথে এই প্যারামিটার সেট করুন। এই প্যারামিটার কীভাবে ব্যবহার করা হয় তা দেখতে, উদাহরণ কীভাবে নর্থবাউন্ড TLS কনফিগার করতে হয় এবং কীভাবে সাউথবাউন্ড TLS কনফিগার করতে হয় দেখুন।

যেমন:

docker run -P -p 8443:8443 -d --name edgemicro \
-v $HOME/.edgemicro:/opt/apigee/.edgemicro \
-v $HOME/.edgemicro:/opt/apigee/logs \
-e NODE_EXTRA_CA_CERTS=/opt/apigee/.edgemicro/rootca.pem \
-e EDGEMICRO_PORT=8443 \
-e EDGEMICRO_ORG=docs \
-e EDGEMICRO_ENV=test \
-e EDGEMICRO_KEY=ac36574905fb54fdae65fc5433e831bec2680efb98220a355f2e917e52973c \
-e EDGEMICRO_SECRET=aac81dff6c326eaa222d53c15c8841fa78ea863bf4472568c9ce2d80a3bc56 \
-e "EDGEMICRO_CONFIG=$EDGEMICRO_CONFIG" \
--link helloworld:helloworld gcr.io/apigee-microgateway/edgemicro

এছাড়াও, Docker কন্টেনার হিসেবে Edge Micro রান করানো দেখুন।

TLS যাচাইকরণ বন্ধ করা

সাজেস্ট করা না হলেও, কিছু ক্ষেত্রে আপনি কন্টেনারে চলা Edge Microgateway-এর জন্য TLS যাচাইকরণ বন্ধ করতে চাইতে পারেন। TLS বন্ধ করার ক্ষমতা ডিফল্ট হিসেবে Edge Microgateway Docker কন্টেনারে বিল্ট-ইন থাকে না। এই টাস্কটি সম্পূর্ণ করতে, আপনাকে Edge Microgateway-এর জন্য কাস্টমাইজ করা Docker ইমেজ তৈরি করতে হবে। কাস্টম ছবি তৈরি করা এবং TLS যাচাইকরণ বন্ধ করার জন্য নিচে সাধারণ নির্দেশাবলী দেওয়া হল।

  1. Edge Microgateway সোর্স রিপোজিটরি ক্লোন বা ডাউনলোড করুন https://github.com/apigee-internal/microgateway।

  2. সোর্স কোড ডিরেক্টরিতে cd থেকে microgateway/kubernetes/docker/edgemicro ডিরেক্টরিতে।

    যেমন:

    cd $HOME/git/microgateway/kubernetes/docker/edgemicro

  3. entrypoint.sh ফাইলটি খুলুন এবং NODE_TLS_REJECT_UNAUTHORIZED এনভায়রনমেন্ট ভেরিয়েবল গ্রহণ করার জন্য কোডটি পরিবর্তন করুন। পরে, কন্টেনার রান করার সময়, আপনি এই ভেরিয়েবলের জন্য একটি ভ্যালু নির্দিষ্ট করবেন।

  4. Docker কন্টেনার তৈরি করুন:

    docker build -t edgemicro .

  5. আপনি কন্টেনার রান করার সময়, -e NODE_TLS_REJECT_UNAUTHORIZED = 1 বিকল্পটি নির্দিষ্ট করুন। যেমন:

docker run -P -p 8443:8443 -d --name edgemicro \
-v $HOME/.edgemicro:/opt/apigee/.edgemicro \
-v $HOME/.edgemicro:/opt/apigee/logs \
-e NODE_TLS_REJECT_UNAUTHORIZED = 1 \
-e EDGEMICRO_PORT=8443 \
-e EDGEMICRO_ORG=docs \
-e EDGEMICRO_ENV=test \
-e EDGEMICRO_KEY=ac36574905fb54fdae65fc5433e831bec2680efb98220a355f2e917e52973c \
-e EDGEMICRO_SECRET=aac81dff6c326eaa222d53c15c8841fa78ea863bf4472568c9ce2d80a3bc56 \
-e "EDGEMICRO_CONFIG=$EDGEMICRO_CONFIG" \
--link helloworld:helloworld gcr.io/apigee-microgateway/edgemicro

যেমন: কীভাবে নর্থবাউন্ড TLS কনফিগার করতে হয়

এই বিভাগে Edge Microgateway সার্ভারে কীভাবে নর্থবাউন্ড (ইনকামিং) TLS কানেকশন সেট-আপ করতে হয় তা ব্যাখ্যা করা হয়েছে। নর্থবাউন্ড TLS, Edge Microgateway-তে API কল করার সময় ক্লায়েন্টকে HTTPS ব্যবহার করার অনুমতি দেয়। নিচে দেওয়া উদাহরণে সেল্ফ-সাইন করা সার্টিফিকেট ব্যবহার করা হয়েছে।

১. প্রাথমিক সেট-আপের ধাপ

  1. আপনার সিস্টেমে openssl.cnf ফাইলটি খুঁজে নিন। যেমন, /etc/ssl/openssl.cnf
  2. এডিট করার জন্য opensssl.cnf ফাইল খুলুন।

  3. কনফিগারেশন ফাইলে req_extensions আছে কিনা তা নিশ্চিত করুন। যেমন, আপনার ফাইলে নিম্নলিখিত তথ্যের মতো তথ্য থাকতে হবে:

    [ req ]
...
req_extensions          = v3_req
...

[ v3_req ]
extendedKeyUsage = serverAuth, clientAuth, codeSigning, emailProtection
basicConstraints = CA:FALSE
keyUsage = nonRepudiation, digitalSignature, keyEncipherment

  4. সঠিক SNI অ্যাট্রিবিউট জেনারেট করতে openssl.cnf-এ নিম্নলিখিত স্তবক যোগ করুন:

    [ alt_names ]
DNS.1 = www.example.com
DNS.2 = example.com
DNS.3 = localhost
DNS.4 = localhost.localdomain
DNS.5 = 127.0.0.1
DNS.6 = ::1
DNS.7 = fe80::1

    opensssl.cnf ফাইলের উদাহরণ:

    [ req ]
distinguished_name      = req_distinguished_name
attributes              = req_attributes
req_extensions          = v3_req

[ v3_req ]
extendedKeyUsage = serverAuth, clientAuth, codeSigning, emailProtection
basicConstraints = CA:FALSE
keyUsage = nonRepudiation, digitalSignature, keyEncipherment

[ req_distinguished_name ]
countryName                     = Country Name (2 letter code)
countryName_min                 = 2
countryName_max                 = 2
stateOrProvinceName             = State or Province Name (full name)
localityName                    = Locality Name (eg, city)
0.organizationName              = Organization Name (eg, company)
organizationalUnitName          = Organizational Unit Name (eg, section)
commonName                      = Common Name (eg, fully qualified host name)
commonName_max                  = 64
emailAddress                    = Email Address
emailAddress_max                = 64

[ req_attributes ]
challengePassword               = A challenge password
challengePassword_min           = 4
challengePassword_max           = 20

[ alt_names ]
DNS.1 = www.example.com
DNS.2 = example.com
DNS.3 = localhost
DNS.4 = localhost.localdomain
DNS.5 = 127.0.0.1
DNS.6 = ::1
DNS.7 = fe80::1

  5. আপনি আগে থেকে না করে থাকলে, Edge Microgateway চালু ও কনফিগার করতে, পূর্বশর্ত বিভাগে দেওয়া ধাপগুলি অনুসরণ করুন। এটি সম্পূর্ণ হয়ে গেলে, আপনার Edge Microgateway-সচেতন প্রক্সি, API প্রোডাক্ট, ডেভেলপার ও ডেভেলপার অ্যাপ তৈরি হয়ে যাবে। এছাড়াও, আপনাকে edgemicro configure কমান্ড চালাতে হবে এবং একটি কী ও সিক্রেট পাবেন।

২. সেল্ফ-সাইন করা সার্টিফিকেট তৈরি করা

এরপরে, TLS সেট-আপ করার জন্য প্রয়োজনীয় সার্টিফিকেট ও কী তৈরি করুন:

  1. $HOME/.edgemicro ডিরেক্টরিতে cd।

  2. নিম্নলিখিত ব্যাশ স্ক্রিপ্ট তৈরি করুন। আপনি নিজের ইচ্ছামতো যেকোনও নাম দিতে পারেন। যেমন: keygen.sh.

    #!/bin/bash
# generate ca
openssl genrsa -out rootca.key 2048
openssl req -x509 -new -nodes -key rootca.key -sha256 -days 1024 -out rootca.pem
# generate key
openssl genrsa -out tls.key 2048
openssl req -new -key tls.key -out tls.csr
# sign cert
openssl x509 -req -in tls.csr -CA rootca.pem -CAkey rootca.key -CAcreateserial -out tls.crt -days 1024 -sha256 -extensions 'v3_req' -extfile path/openssl.cnf

  3. bash ফাইলে, openssl.cnf ফাইলের পাথ সঠিক আছে কিনা তা নিশ্চিত করুন।

  4. bash ফাইল এক্সিকিউট করুন। আপনাকে সার্টিফিকেট সংক্রান্ত তথ্য দিতে বলা হবে। সাধারণ নামের জন্য localhost ব্যবহার করতে ভুলবেন না।

  5. নিচের ফাইলগুলি তৈরি হয়েছে কিনা তা চেক করুন:

    • rootca.key
    • rootca.pem
    • tls.key
    • tls.csr
    • rootca.srl
    • tls.crt

৩. Edge Microgateway কনফিগারেশন ফাইল এডিট করা

  1. এডিটরে Edge Micro কনফিগারেশন ফাইল খুলুন। যেমন:

    vi $HOME/.edgemicro/myorg-test-config.yaml

  2. নিচে উল্লেখ করা পদ্ধতি অনুসরণ করে edgemicro স্তবক এডিট করুন। মনে রাখবেন, আপনি port এবং ssl অ্যাট্রিবিউটে পরিবর্তন করছেন:

    edge_config:
...
edgemicro:
  port: 8443
  max_connections: 1000
  config_change_poll_interval: 600
  ssl:
    key: /opt/apigee/.edgemicro/tls.key
    cert: /opt/apigee/.edgemicro/tls.crt
    passphrase: admin123
    rejectUnauthorized: true
    requestCert: false
  logging:
...

  3. $HOME/.edgemicro-এ থাকা Edge Microgateway কনফিগারেশন ফাইলকে base64-এনকোড করতে নিম্নলিখিত কমান্ডটি এক্সিকিউট করুন:

    export EDGEMICRO_CONFIG=`base64 $HOME/.edgemicro/your_org-your_env-config.yaml`

    যেখানে your_org ও your_env হল সেইসব সংস্থা ও এনভায়র্নমেন্ট যা আপনি edgemicro config কমান্ড চালানোর সময় ব্যবহার করেছেন।

    কমান্ডের চারপাশে ব্যাক-টিক (`) দিতে ভুলবেন না। যেমন:

    export EDGEMICRO_CONFIG=`base64 $HOME/.edgemicro/docs-test-config.yaml`

এছাড়াও, Docker কন্টেনার হিসেবে Edge Micro রান করা দেখুন।

৪. কন্টেনার চালানো

  1. Edge Microgateway সহ Docker কন্টেনার রান করাতে, নিম্নলিখিত কমান্ডটি এক্সিকিউট করুন:

    docker run -P -p 8443:8443 -d --name edgemicro \
-v path_to_your_edgemicro_dir:/opt/apigee/.edgemicro \
-v path_to_your_logs_dir:/opt/apigee/logs \
-e NODE_EXTRA_CA_CERTS=/opt/apigee/.edgemicro/rootca.pem \
-e EDGEMICRO_PORT=8443 \
-e EDGEMICRO_ORG=$EDGEMICRO_ORG \
-e EDGEMICRO_ENV=$EDGEMICRO_ENV \
-e EDGEMICRO_KEY=$EDGEMICRO_KEY \
-e EDGEMICRO_SECRET=$EDGEMICRO_SECRET \
-e "EDGEMICRO_CONFIG=$EDGEMICRO_CONFIG" \
gcr.io/apigee-microgateway/edgemicro:latest

  2. কমান্ডে ব্যবহৃত নিম্নলিখিত প্যারামিটারগুলি লক্ষ্য করুন; এগুলি Docker কন্টেনার হিসেবে Edge Micro রান করান-এ বর্ণিত মৌলিক কমান্ড থেকে আলাদা।

    • port-এর মান 8443 হিসেবে সেট করা আছে।
    • কী ও cert ফাইল মাউন্ট করতে ভলিউম মাউন্ট ব্যবহার করা হয়।
    • NODE_EXTRA_CA_CERTS ভেরিয়েবলটি কাস্টম CA যোগ করতে ব্যবহার করা হয় (স্বাক্ষরিত সার্টিফিকেট এর ক্ষেত্রে প্রয়োজন)।

৫. TLS কনফিগারেশন পরীক্ষা করা

  1. সেট-আপ পরীক্ষা করে দেখতে, নিম্নলিখিত cURL কমান্ডটি এক্সিকিউট করুন। কমান্ডে আপনার basepath ও API key যোগ করুন। নিচের উদাহরণে ধরে নেওয়া হয়েছে যে আপনি সেই ডিরেক্টরিতে আছেন যেখানে rootca.pem আছে এবং আপনার তৈরি করা প্রক্সির বেসপাথ /hello:

    curl -v https://localhost:8443/hello --cacert rootca.pem \
-H "x-api-key: Az82fdnfONVCOOE4NKhajxAboDgA3FAo"

  2. verbose cURL আউটপুট TLS হ্যান্ডশেকিংয়ের প্রতিটি ধাপ দেখায়। আপনি HTTP 200 উত্তর দেখতে পেলে, কনফিগারেশন সফল হয়েছে:

    *   Trying ::1...ey:Az82fdnfONVCOOE4NKhajxAboDgA3FAo"
* TCP_NODELAY set
* Connected to localhost (::1) port 8443 (#0)
* ALPN, offering h2
* ALPN, offering http/1.1
* Cipher selection: ALL:!EXPORT:!EXPORT40:!EXPORT56:!aNULL:!LOW:!RC4:@STRENGTH
* successfully set certificate verify locations:
*   CAfile: rootca.pem
  CApath: none
* TLSv1.2 (OUT), TLS handshake, Client hello (1):
* TLSv1.2 (IN), TLS handshake, Server hello (2):
* TLSv1.2 (IN), TLS handshake, Certificate (11):
* TLSv1.2 (IN), TLS handshake, Server key exchange (12):
* TLSv1.2 (IN), TLS handshake, Server finished (14):
* TLSv1.2 (OUT), TLS handshake, Client key exchange (16):
* TLSv1.2 (OUT), TLS change cipher, Client hello (1):
* TLSv1.2 (OUT), TLS handshake, Finished (20):
* TLSv1.2 (IN), TLS change cipher, Client hello (1):
* TLSv1.2 (IN), TLS handshake, Finished (20):
* SSL connection using TLSv1.2 / ECDHE-RSA-AES128-GCM-SHA256
* ALPN, server accepted to use http/1.1
* Server certificate:
*  subject: C=US; ST=CO; L=Boulder; O=Docs; OU=Docs; CN=localhost; emailAddress=docs@apigee.com
*  start date: Dec 14 22:35:28 2018 GMT
*  expire date: Oct  3 22:35:28 2021 GMT
*  common name: localhost (matched)
*  issuer: C=US; ST=CO; L=Boulder; O=Docs; OU=Docs; CN=localhost; emailAddress=docs@apigee.com
*  SSL certificate verify ok.
> GET /hello HTTP/1.1
> Host: localhost:8443
> User-Agent: curl/7.54.0
> Accept: */*
> x-api-key:Az82fdnfaONVCOE4NKhajxAboDA3FAo
>
< HTTP/1.1 200 OK
< x-powered-by: Apigee
< access-control-allow-origin: *
< x-frame-options: ALLOW-FROM RESOURCE-URL
< x-xss-protection: 1
< x-content-type-options: nosniff
< content-type: text/plain; charset=utf-8
< etag: W/"d-GHB1ZrJKk/wdVTdB/jgBsw"
< date: Fri, 14 Dec 2018 22:43:13 GMT
< via: 1.1 google
< alt-svc: clear
< x-response-time: 1325
< Connection: keep-alive
< Transfer-Encoding: chunked
<
* Connection #0 to host localhost left intact
Hello, Guest!

উদাহরণ: সাউথবাউন্ড TLS কীভাবে কনফিগার করতে হয়

এই বিভাগে Edge Microgateway সার্ভার এবং ব্যাকএন্ড টার্গেট অ্যাপ্লিকেশনের মধ্যে সাউথবাউন্ড (আউটগোয়িং) TLS কানেকশন কীভাবে সেট-আপ করতে হয় তা ব্যাখ্যা করা হয়েছে। নিচের উদাহরণে স্বাক্ষরিত সার্টিফিকেট ব্যবহার করা হয়েছে।

১. প্রাথমিক সেট-আপের ধাপ

  1. আপনার সিস্টেমে openssl.cnf ফাইলটি খুঁজে নিন। যেমন, /etc/ssl/openssl.cnf
  2. এডিট করার জন্য opensssl.cnf ফাইল খুলুন।

  3. কনফিগারেশন ফাইলে req_extensions আছে কিনা তা নিশ্চিত করুন। যেমন, আপনার ফাইলে নিম্নলিখিত তথ্যের মতো তথ্য থাকতে হবে:

    [ req ]
...
req_extensions          = v3_req
...

[ v3_req ]
extendedKeyUsage = serverAuth, clientAuth, codeSigning, emailProtection
basicConstraints = CA:FALSE
keyUsage = nonRepudiation, digitalSignature, keyEncipherment

  4. সঠিক SNI অ্যাট্রিবিউট জেনারেট করতে openssl.cnf-এ নিম্নলিখিত স্তবক যোগ করুন:

    [ alt_names ]
DNS.1 = helloworld
DNS.2 = localhost
DNS.3 = localhost.localdomain
DNS.4 = 127.0.0.1
DNS.5 = ::1
DNS.6 = fe80::1

    opensssl.cnf ফাইলের উদাহরণ:

    [ req ]
distinguished_name      = req_distinguished_name
attributes              = req_attributes
req_extensions          = v3_req

[ v3_req ]
extendedKeyUsage = serverAuth, clientAuth, codeSigning, emailProtection
basicConstraints = CA:FALSE
keyUsage = nonRepudiation, digitalSignature, keyEncipherment

[ req_distinguished_name ]
countryName                     = Country Name (2 letter code)
countryName_min                 = 2
countryName_max                 = 2
stateOrProvinceName             = State or Province Name (full name)
localityName                    = Locality Name (eg, city)
0.organizationName              = Organization Name (eg, company)
organizationalUnitName          = Organizational Unit Name (eg, section)
commonName                      = Common Name (eg, fully qualified host name)
commonName_max                  = 64
emailAddress                    = Email Address
emailAddress_max                = 64

[ req_attributes ]
challengePassword               = A challenge password
challengePassword_min           = 4
challengePassword_max           = 20

[ alt_names ]
DNS.1 = helloworld
DNS.2 = localhost
DNS.3 = localhost.localdomain
DNS.4 = 127.0.0.1
DNS.5 = ::1
DNS.6 = fe80::1

  5. edgemicro configure কমান্ড রান করুন:

    edgemicro configure -o your_org -e your_env -u your_username

    কনফিগারেশন সম্পর্কে আরও বিবরণের জন্য, পার্ট ১: Edge Microgateway কনফিগার করুন দেখুন।

  6. edgemicro configure থেকে পাওয়া কী ও গোপন ক্রেডেনশিয়াল কপি করুন। কন্টেনার চালানোর জন্য আপনার এইসব ভ্যালু প্রয়োজন হবে। যেমন:

    The following credentials are required to start edge micro
  key: d9c34e1aff68ed969273c016699eabf48780e4f652242e72fc88a43e21252cb0
  secret: 3bc95a71c86a3c8ce04537fbcb788158731t51dfc6cdec13b7c05aa0bd969430

২. Node.js টার্গেট অ্যাপ্লিকেশন তৈরি করা

  1. .edgemicro ডিরেক্টরিতে cd।

  2. নিম্নলিখিত ব্যাশ স্ক্রিপ্ট তৈরি করুন। আপনি নিজের ইচ্ছামতো যেকোনও নাম দিতে পারেন। যেমন: keygen.sh.

    #!/bin/bash
# generate ca
openssl genrsa -out rootca.key 2048
openssl req -x509 -new -nodes -key rootca.key -sha256 -days 1024 -out rootca.pem
# generate key
openssl genrsa -out tls.key 2048
openssl req -new -key tls.key -out tls.csr
# sign cert
openssl x509 -req -in tls.csr -CA rootca.pem -CAkey rootca.key -CAcreateserial -out tls.crt -days 1024 -sha256 -extensions 'v3_req' -extfile path/openssl.cnf

  3. bash ফাইলে, openssl.cnf ফাইলের পাথ সঠিক আছে কিনা তা নিশ্চিত করুন।

  4. bash ফাইল এক্সিকিউট করুন। আপনাকে সার্টিফিকেট সংক্রান্ত তথ্য দিতে বলা হবে। সাধারণ নামের জন্য hellworld ব্যবহার করতে ভুলবেন না।

  5. নিচের ফাইলগুলি তৈরি হয়েছে কিনা তা চেক করুন:

    • rootca.key
    • rootca.pem
    • tls.key
    • tls.csr
    • rootca.srl
    • tls.crt

  6. server.js নামের একটি নতুন ফাইল তৈরি করুন।

    'use strict';

const express = require('express');
const https = require('https');
const fs = require('fs');

const options = {
  key: fs.readFileSync("tls.key"),
  cert: fs.readFileSync("tls.crt")
};

// Constants
const PORT = 9443;
const HOST = '0.0.0.0';

// App
const app = express();
app.get('/', (req, res) => {
  res.send('Hello world\n');
});

https.createServer(options, app).listen(PORT);

  7. server.js-এর মতো একই ডিরেক্টরিতে package.json ফাইল তৈরি করুন। যেমন:

    {
  "name": "helloworld",
  "version": "1.0.0",
  "description": "",
  "main": "server.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "start": "node server.js"
  },
  "author": "",
  "license": "ISC",
  "dependencies": {
    "express": "^4.16.4",
    "fs": "0.0.1-security",
    "https": "^1.0.0"
  }
}

  8. নির্ভরতা পেতে npm install রান করুন।

  9. server.js-এর মতো একই ডিরেক্টরিতে একটি নতুন Dockerfile তৈরি করুন, যেখানে WORKDIR হল আপনার Node.js অ্যাপের রুটের পাথ:

    FROM node:8-alpine
WORKDIR path-to-your-node-app
COPY package*.json ./

RUN npm install
COPY . .
EXPOSE 9443
CMD [ "npm", "start" ]

  10. Docker ইমেজ তৈরি করুন:

    docker build -t helloworld .

  11. স্যাম্পেল অ্যাপ চালু করুন:

    docker run -P -p 9443:9443 --name helloworld helloworld

৩. Apigee Edge-এ এন্টিটি তৈরি করা

  1. এইসব সেটিংস সহ Edge Microgateway-সচেতন প্রক্সি তৈরি করুন। আরও তথ্যের জন্য, Edge-এ Edge Microgateway-সচেতন API প্রক্সি তৈরি করুন দেখুন।

    • প্রক্সির নাম: edgemicro_local
    • সংশোধন: 1
    • Basepath: /local
    • টার্গেট: https://helloworld:9443

  2. API প্রোডাক্ট তৈরি করুন। আরও বিবরণের জন্য, প্রোডাক্ট তৈরি করুন দেখুন।

  3. ডেভেলপার তৈরি করুন। বিস্তারিত জানতে, ডেভেলপার তৈরি করুন দেখুন।

  4. ডেভেলপার অ্যাপ তৈরি করুন। বিস্তারিত জানতে, ডেভেলপার অ্যাপ তৈরি করুন দেখুন

৪. কন্টেনার চালানো

  1. এডিটরে Edge Micro কনফিগারেশন ফাইল খুলুন। যেমন:

    vi $HOME/.edgemicro/myorg-test-config.yaml

  2. নিচে উল্লেখ করা পদ্ধতি অনুসরণ করে edgemicro স্তবক এডিট করুন। মনে রাখবেন, আপনি port এবং ssl অ্যাট্রিবিউটে পরিবর্তন করছেন:

    edge_config:
...
edgemicro:
  port: 8443
  max_connections: 1000
  config_change_poll_interval: 600
  ssl:
    key: /opt/apigee/.edgemicro/tls.key
    cert: /opt/apigee/.edgemicro/tls.crt
    passphrase: admin123
    rejectUnauthorized: true
    requestCert: false
  logging:
...

  3. $HOME/.edgemicro-এ থাকা Edge Microgateway কনফিগারেশন ফাইলকে base64-এনকোড করতে নিম্নলিখিত কমান্ডটি এক্সিকিউট করুন:

    export EDGEMICRO_CONFIG=`base64 $HOME/.edgemicro/your_org-your_env-config.yaml`

    যেখানে your_org ও your_env হল সেইসব সংস্থা ও এনভায়র্নমেন্ট যা আপনি edgemicro config কমান্ড চালানোর সময় ব্যবহার করেছেন।

    কমান্ডের চারপাশে ব্যাক-টিক (`) দিতে ভুলবেন না। যেমন:

    export EDGEMICRO_CONFIG=`base64 $HOME/.edgemicro/docs-test-config.yaml`

  4. Docker কন্টেনারে Edge Microgateway চালু করতে, নিম্নলিখিত কমান্ড রান করুন।

    docker run -P -p 8443:8443 -d --name edgemicro \
-v path_to_your_edgemicro_dir:/opt/apigee/.edgemicro \
-v path_to_your_logs_dir:/opt/apigee/logs \
-e EDGEMICRO_PORT=8443 \
-e EDGEMICRO_ORG=$EDGEMICRO_ORG \
-e EDGEMICRO_ENV=$EDGEMICRO_ENV \
-e EDGEMICRO_KEY=$EDGEMICRO_KEY \
-e EDGEMICRO_SECRET=$EDGEMICRO_SECRET \
-e "EDGEMICRO_CONFIG=$EDGEMICRO_CONFIG" \
--link helloworld:helloworld gcr.io/apigee-microgateway/edgemicro

৫. TLS কনফিগারেশন পরীক্ষা করা

  1. সেট-আপ পরীক্ষা করে দেখতে, নিম্নলিখিত cURL কমান্ডটি এক্সিকিউট করুন। মাইক্রোগেটওয়ে-অ্যাওয়ার প্রক্সি এবং Apigee Edge-এ আপনার তৈরি করা Developer অ্যাপ থেকে পাওয়া API কী-তে আপনার ব্যবহার করা বেসপাথ পরিবর্তন করুন। যেমন:

    curl https://localhost:8443/local -k -H "x-api-key: xxxx" -v

    আপনি এই সমস্যাটি দেখতে পাবেন:

    ...
*  subject: C=CA; ST=Ontario; L=Toronto; O=Google Canada; OU=Google Cloud Platform; CN=edgemicro; emailAddress=srinandans@google.com
*  start date: Dec 10 02:12:22 2018 GMT
*  expire date: Sep 29 02:12:22 2021 GMT
*  issuer: C=CA; ST=Ontario; L=Toronto; O=Google Canada; OU=Google Cloud Platform; CN=edgemicro; emailAddress=srinandans@google.com
*  SSL certificate verify result: unable to get local issuer certificate (20), continuing anyway.
> GET /local HTTP/1.1
> Host: localhost:8443
> User-Agent: curl/7.54.0
> Accept: */*
> x-api-key: 9fVC65pFj8LrmlPmVyxFjx4KgAHTxqSd
>
< HTTP/1.1 502 Bad Gateway
< Date: Wed, 12 Dec 2018 05:25:01 GMT
< Connection: keep-alive
< Content-Length: 93
<
* Connection #0 to host localhost left intact
{"message":"unable to verify the first certificate","code":"UNABLE_TO_VERIFY_LEAF_SIGNATURE"}

  2. Edge Microgateway আবার রান করুন, তবে এইবার NODE_EXTRA_CA_CERTS ভেরিয়েবল যোগ করুন।

    docker run -P -p 8443:8443 -d --name edgemicro \
-v path_to_your_edgemicro_dir:/opt/apigee/.edgemicro \
-v path_to_your_logs_dir:/opt/apigee/logs \
-e NODE_EXTRA_CA_CERTS=/opt/apigee/.edgemicro/rootca.pem \
-e EDGEMICRO_PORT=8443 \
-e EDGEMICRO_ORG=$EDGEMICRO_ORG \
-e EDGEMICRO_ENV=$EDGEMICRO_ENV \
-e EDGEMICRO_KEY=$EDGEMICRO_KEY \
-e EDGEMICRO_SECRET=$EDGEMICRO_SECRET \
-e "EDGEMICRO_CONFIG=$EDGEMICRO_CONFIG" \
--link helloworld:helloworld gcr.io/apigee-microgateway/edgemicro

  3. নিম্নলিখিত cURL কমান্ডটি এক্সিকিউট করুন। আগের মতো আপনার basepath ও API key পরিবর্তন করুন। যেমন:

    curl https://localhost:8443/local -k -H "x-api-key: xxxx" -v

  4. আউটপুট চেক করুন। সফল হলে, আপনি HTTP 200 স্ট্যাটাস রেসপন্স পাবেন:

    ...
> GET /local HTTP/1.1
> Host: localhost:8443
> User-Agent: curl/7.54.0
> Accept: */*
> x-api-key: 9fVC65pFj8LrmlPmVyxFjx4KgAHTxqSd
>
< HTTP/1.1 200 OK
< x-powered-by: Express
< content-type: text/html; charset=utf-8
< etag: W/"c-M6tWOb/Y57lesdjQuHeB1P/qTV0"
< date: Wed, 12 Dec 2018 05:49:28 GMT
< x-response-time: 421
< Connection: keep-alive
< Transfer-Encoding: chunked
<
Hello world

কাস্টম প্লাগ-ইন যোগ করা

কাস্টম প্লাগ-ইন লিখে আপনি মাইক্রোগেটওয়েতে নতুন ফিচার ও কেপেবিলিটি যোগ করতে পারবেন। কাস্টম প্লাগ-ইন আপনাকে মাইক্রোগেটওয়ের মাধ্যমে প্রবাহিত হওয়া অনুরোধ ও উত্তরের সাথে প্রোগ্রাম্যাটিকভাবে ইন্টার‍্যাক্ট করতে দেয়।

ডকার কন্টেনারে রান করছে এমন Edge Microgateway ইনস্ট্যান্সে প্লাগ-ইন ডেপ্লয় করার জন্য আপনার কাছে দুটি বিকল্প আছে:

এই বিভাগের বাকি অংশ ধরে নেয় যে আপনি স্ট্যান্ডার্ড Edge Microgateway সেট-আপের জন্য প্লাগ-ইন লেখা ও কনফিগার করার ব্যাপারে পরিচিত। তা না হলে, কাস্টম প্লাগ-ইন ডেভেলপ করুন দেখুন।

বিকল্প 'ক': ভলিউমে প্লাগ-ইন ডিরেক্টরি মাউন্ট করা

(v.2.5.27-এ যোগ করা হয়েছে) ভলিউম মাউন্টের মাধ্যমে প্লাগ-ইন যোগ করার ধাপগুলি Edge Microgateway-তে কোনও কাস্টম প্লাগ-ইন যোগ করার জন্য প্রয়োজনীয় ধাপগুলির মতোই। আপনি Docker কন্টেনার রান করালে, কন্টেনার মাউন্ট পয়েন্টে আপনার লোকাল সিস্টেমের (ভলিউম) প্লাগ-ইন ডিরেক্টরি মাউন্ট করতে পারবেন। কন্টেনার মাউন্ট পয়েন্ট হল /opt/apigee/plugins। তারপরে, Edge Microgateway কনফিগারেশন ফাইলে স্থানীয় ভলিউম ডিরেক্টরি নির্দিষ্ট করেন।

কাস্টম প্লাগ-ইন যোগ করার জন্য কীভাবে Docker মাউন্ট পয়েন্ট ব্যবহার করতে হয় তা নিম্নলিখিত ধাপগুলি থেকে জানতে পারবেন।

  1. Edge Microgateway বন্ধ করুন:

    edgemicro stop

  2. আপনার কাস্টম প্লাগ-ইনের জন্য একটি ডিরেক্টরি তৈরি করুন। যেমন,

    $HOME/edgemicro/custom/plugins

  3. Edge Microgateway কনফিগারেশন ফাইলে কাস্টম প্লাগ-ইন ডিরেক্টরি যোগ করুন। যেমন:

      plugins:
    dir: $HOME/edgemicro/custom/plugins
    sequence:
      - oauth
      - response-uppercase
  ````

  4. একটি সাধারণ প্লাগ-ইন লেখা নিবন্ধে দেওয়া নির্দেশাবলী অনুযায়ী আপনার প্লাগ-ইন লিখুন ও পরীক্ষা করুন। নিশ্চিত করুন যে আপনি সঠিক ডিরেক্টরি স্ট্রাকচারে আপনার প্লাগ-ইন কোড রেখেছেন। যেমন:

    custom
  |
  |-- plugins
    |
    |- response-uppercase
    |     |- index.js
    |     |- package.json
    |- request-headers
    |     | - index.js
          | - package.json

  5. নিম্নলিখিত কমান্ডের মতো কমান্ড দিয়ে Docker কন্টেনার রান করান, যেখানে আপনি Docker ভলিউমে প্লাগ-ইন ডিরেক্টরি মাউন্ট করতে -v বিকল্প ব্যবহার করেন। নিচের কমান্ডের উদাহরণে, প্লাগ-ইন ডিরেক্টরি $HOME/edgemicro/custom/plugins (যেখানে কাস্টম প্লাগ-ইন থাকে) কন্টেনারের মাউন্ট পয়েন্টের /opt/apigee/pluginsসাথে ম্যাপ করা হয়:

    docker run -P -p 8000:8000 -d --name edgemicro \
-v /var/tmp:/opt/apigee/logs \
-v $HOME/edgemicro/custom/plugins:/opt/apigee/plugins \
-e EDGEMICRO_PROCESSES=1 \
-e EDGEMICRO_ORG=jdoe \
-e EDGEMICRO_ENV=test \
-e EDGEMICRO_KEY=39c4b561100cd7f258768d1072f3e1d7c17b5f36a18fe89972bb5c9ce7e58fb \
-e EDGEMICRO_SECRET=f5f9e239a38b4e6cc99c2aa067716a84aebdcff9580a7925fc500e402b1a5fa \
-e "EDGEMICRO_CONFIG=$EDGEMICRO_CONFIG" \
-e SERVICE_NAME=edgemicro \
--security-opt=no-new-privileges \
--cap-drop=ALL gcr.io/apigee-microgateway/edgemicro:latest

  6. প্লাগ-ইন পরীক্ষা করতে আপনার API কল করুন।

আরও তথ্যের জন্য, VOLUME [shared filesystems] দেখুন।

বিকল্প খ: কন্টেনারের মধ্যে প্লাগ-ইন তৈরি করা

এই বিকল্পে, আপনি কন্টেনারের মধ্যে প্লাগ-ইন তৈরি করেন।

১. আপনার প্লাগ-ইন প্যাকেজ করা

  1. একটি সাধারণ প্লাগ-ইন লেখা নিবন্ধে দেওয়া নির্দেশাবলী অনুযায়ী আপনার প্লাগ-ইন লিখুন ও পরীক্ষা করুন।

  2. সঠিক ডিরেক্টরি স্ট্রাকচারে আপনার প্লাগ-ইন কোড রাখুন। প্লাগ-ইন ডিরেক্টরিকে একটি নির্দিষ্ট স্ট্রাকচার মেনে চলতে হবে। আপনাকে যে স্ট্রাকচার অনুসরণ করতে হবে তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে, যেখানে response-uppercase এবং request-headers হল কাস্টম প্লাগ-ইন কোড থাকা ফোল্ডারের নাম (এই নামগুলি শুধুমাত্র উদাহরণ, আপনার ফোল্ডারের নাম আলাদা হতে পারে):

    plugin
  |
  |-- plugins
    |
    |- response-uppercase
    |     |- index.js
    |     |- package.json
    |- request-headers
    |     | - index.js
          | - package.json

  3. cd থেকে plugin ফোল্ডারে।

  4. plugin ফোল্ডারে, সম্পূর্ণ plugins ফোল্ডার জিপ করুন:

    zip -r plugins.zip plugins/

২. Docker ইমেজ তৈরি করা

এরপরে, Edge Microgateway ইমেজে আপনার প্লাগ-ইন কোড যোগ করতে একটি Dockerfile তৈরি করুন।

  1. জিপ ফাইলটি যেখানে আছে সেই একই ডিরেক্টরিতে, Dockerfile নামে একটি নতুন ফাইল তৈরি করুন।

  2. Dockerfile-এ নিম্নলিখিত কোড যোগ করুন এবং ফাইলটি সেভ করুন:

    USER root
RUN apk update && \
    apk upgrade && \
    apk add zipapk add zip && \
    mkdir /opt/apigee/customplugins && \
    chown apigee:apigee /opt/apigee/customplugins
COPY plugins.zip /opt/apigee/customplugins
RUN su - apigee -c "unzip /opt/apigee/customplugins/plugins.zip -d /opt/apigee/customplugins"
EXPOSE 8000
EXPOSE 8443
USER apigee
ENTRYPOINT ["entrypoint"]

  3. আপনার প্লাগ-ইন সহ একটি নতুন Edge Microgateway Docker ইমেজ তৈরি করুন:

    docker build -t image-name .

    যেমন:

    docker build -t edgemicroplugins .

৩. Edge Microgateway কনফিগারেশন আপডেট করা

প্লাগ-ইন প্যাকেজ করা হয়ে গেলে, আপনাকে Edge Microgateway কনফিগারেশন ফাইলে সেগুলি যোগ করতে হবে।

  1. এডিটরে Edge Microgateway কনফিগারেশন ফাইল খুলুন:

    $HOME/.edgemicro/org-env-config.yaml

    যেমন:

    vi $HOME/.edgemicro/myorg-test-config.yaml

  2. কনফিগারেশন ফাইলে প্লাগ-ইন ডিরেক্টরি যোগ করুন। নিম্নলিখিত উদাহরণে dir অ্যাট্রিবিউট প্লাগ-ইন কোডের লোকেশন নির্দিষ্ট করে (যা আপনি Dockerfile-এ নির্দিষ্ট করেছেন)। এছাড়াও, আপনাকে অবশ্যই প্লাগ-ইন ডিরেক্টরির নাম উল্লেখ করতে হবে, যা নিচের উদাহরণে response-uppercase। 

    edgemicro:
  ...
  plugins:
    dir: /opt/apigee/plugins
    sequence:
      - oauth
      - response-uppercase

৪. মাইক্রোগেটওয়ে চালু করা

সবশেষে, আপনাকে কন্টেনারে মাইক্রোগেটওয়ে চালু করতে হবে।

  1. $HOME/.edgemicro-এ থাকা Edge Microgateway কনফিগারেশন ফাইলকে base64-এনকোড করতে নিম্নলিখিত কমান্ডটি রান করুন:

    export EDGEMICRO_CONFIG=`base64 $HOME/.edgemicro/your_org-your_env-config.yaml`

    যেখানে your_org ও your_env হল সেইসব সংস্থা ও এনভায়র্নমেন্ট যা আপনি edgemicro config কমান্ড চালানোর সময় ব্যবহার করেছেন।

    কমান্ডের চারপাশে ব্যাক-টিক (`) দিতে ভুলবেন না। যেমন:

    export EDGEMICRO_CONFIG=`base64 $HOME/.edgemicro/docs-test-config.yaml`

  2. কন্টেনার হিসেবে Edge Microgateway চালান। এই কমান্ডটি বেশ কিছু এনভায়রনমেন্ট ভেরিয়েবল সেট করে যা Edge Microgateway চালু করার জন্য কন্টেনার রানটাইম ব্যবহার করে:

    docker run -P -p 8000:8000 -d --name edgemicroplugins \
-e EDGEMICRO_PLUGIN_DIR=/opt/apigee/customplugins/plugins \
-e EDGEMICRO_ORG=your_org \
-e EDGEMICRO_ENV=your_env \
-e EDGEMICRO_KEY=your_key \
-e EDGEMICRO_SECRET=your_secret \
-e "EDGEMICRO_CONFIG=$EDGEMICRO_CONFIG" \
-e SERVICE_NAME=edgemicroplugins image_name

    যেমন:

    docker run -P -p 8000:8000 -d --name edgemicroplugins \
-e EDGEMICRO_PLUGIN_DIR=/opt/apigee/customplugins/plugins \
-e EDGEMICRO_ORG=docs \
-e EDGEMICRO_ENV=test \
-e EDGEMICRO_KEY=d9c34e1aff68ed969273b016699eabf48780e4f652242e72fc88a23e21252cb0 \
-e EDGEMICRO_SECRET=3bc95a71c86a3c8ce04137fbcb788158731t51dfc6cdec13b7c05aa0bd969430 \
-e "EDGEMICRO_CONFIG=$EDGEMICRO_CONFIG" \
-e SERVICE_NAME=edgemicroplugins edgemicroplugins

  3. প্লাগ-ইন পরীক্ষা করতে আপনার API কল করুন:

    আপনার API কল করে এবং আউটপুট প্রত্যাশিত কিনা তা যাচাই করে প্লাগ-ইন কোড এক্সিকিউট হয় কিনা তা পরীক্ষা করুন:

    curl -i http://localhost:8000/hello -H "x-api-key:apikey"

    যেমন, response-uppercase প্লাগ-ইন এই ধরনের উত্তর দিতে পারে:

    curl -i http://localhost:8000/hello -H "x-api-key:PydUKRDGIXRqF2xh4usn1FLHbhGKVIz"
  HELLO, WORLD!