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

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

এই বিষয়ে 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-aware প্রক্সি, 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 রান করুন। কমান্ডটি বেশ কয়েকটি এনভায়রনমেন্ট ভেরিয়েবল সেট করে যা এজ মাইক্রোগেটওয়ে শুরু করার জন্য কন্টেইনার রানটাইম দ্বারা ব্যবহৃত হয়:

    chown -R 100:101 ~/.edgemicro/ \
    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 "LOG_CONSOLE_OUTPUT_TO_FILE=false" \
    -e SERVICE_NAME=edgemicro \
    --security-opt=no-new-privileges \
    --cap-drop=ALL \
    gcr.io/apigee-microgateway/edgemicro:latest

    প্যারামিটার

      <tr>
        <td><code>SERVICE_NAME</code></td>
        <td>If you are on Kubernetes, this parameter is auto-populated. Otherwise,
          you can set it to anything you wish. If you specify nothing, the service
          name is set to <code>default</code>.</td>
      </tr>
      <tr>
        <tr>
        <td><code>DEBUG</code></td>
        <td>Set to <code>*</code> to enable debugging. </td>
      </tr>
      <tr>
        <td><code>HTTP_PROXY</code>
            <code>HTTPS_PROXY</code></td>
        <td>Use when Edge Microgateway is
          running behind a firewall and the gateway cannot communicate with Apigee
          Edge. For more
          information, see <a href="operation-and-configuration-reference-edge-microgateway#settingupedgemicrogatewaybehindacompanyfirewall">Setting up Edge Microgateway behind a company firewall</a>. 
          <p>For example: <code>HTTP_PROXY=http://10.203.0.1:5187/</code></p></td>
      </tr>
      <tr>
        <td><code>NO_PROXY</code></td>
        <td>A comma delimited list of domains that Edge Microgateway should not proxy to. 
          For more information, see <a href="operation-and-configuration-reference-edge-microgateway#settingupedgemicrogatewaybehindacompanyfirewall">Setting up Edge Microgateway behind a company firewall</a>.
          <p>For example: <code>localhost,127.0.0.1,localaddress,.localdomain.com</code></p></td>
      </tr>
      <tr>
      <tr>
        <tr>
        <td><code>NODE_EXTRA_CA_CERTS</code></td>
        <td>(Optional) Use this parameter if you are using a CA that's not trusted
          by default by Node.js. Set the value of this parameter to the path to a
          file containing one or more trusted certificates in PEM format. For
          details, see <a href="#tls_certificates">TLS certificates</a>.</td>
      </tr>
      <tr>
        <td><code>--security-opt</code></td>
        <td>(Optional) Sets desired Docker security options. See <a href="https://docs.docker.com/engine/reference/run/#security-configuration">Security configuration</a> in the Docker documentation.</td>
      </tr>
      <tr>
        <td><code>--cap-drop</code></td>
        <td>(Optional) Sets limits on Linux capabilities permitted in the container. See <a href="https://docs.docker.com/engine/reference/run/#runtime-privilege-and-linux-capabilities">Runtime privilege and Linux capabilities</a> in the Docker documentation.</td>
      </tr>
    </tbody>
    

    প্যারামিটার বিবরণ
    -P হোস্টে সব এক্সপোজড পোর্ট প্রকাশ করুন। এছাড়াও, Docker রান রেফারেন্স দেখুন।
    -p একটি পোর্ট বা পোর্টের রেঞ্জ স্পষ্টভাবে ম্যাপ করুন। এছাড়াও, Docker রান রেফারেন্স দেখুন।
    -d ডিটাচড মোডে রান করুন। এছাড়াও, Docker রান রেফারেন্স দেখুন।
    -v, -- volume ভলিউম মাউন্ট নির্দিষ্ট করে। মনে রাখবেন যে আপনি যদি Docker কন্টেনারে TLS ব্যবহার করার জন্য Edge Microgateway কনফিগার করেন, তাহলে লগ ফাইল ডিরেক্টরি মাউন্ট করলে আপনাকে অবশ্যই পোর্ট 8443 এক্সপোজ করতে হবে। এছাড়াও, VOLUME [শেয়ার করা ফাইলসিস্টেম] দেখুন। এছাড়াও, Docker কন্টেনারে TLS ব্যবহার করা দেখুন।
    -w, -- workdir (ঐচ্ছিক) ডিরেক্টরির পাথ উল্লেখ করে যেখানে edgemicro.sock এবং edgemicro.pid ফাইল তৈরি করা উচিত। আপনি ফাইলের নামের রুট edgemicro পরিবর্তন করতে পারবেন না। ডিফল্ট হিসেবে বর্তমান ওয়ার্কিং ডিরেক্টরি পাথ সেট করা থাকে।

    উদাহরণ:

    docker run -P -p 8000:8000 -d -w /tmp --name edgemicro 
    ...
    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 কনফিগারেশন ফাইল সহ একটি ভেরিয়েবেল।
    LOG_CONSOLE_OUTPUT_TO_FILE (বুলিয়ান) লগ আউটপুট কোথায় পাঠানো হবে তা নির্দিষ্ট করার অনুমতি দেয়। লগ ফাইল সংক্রান্ত বিকল্প নির্দিষ্ট করা দেখুন।

    যেমন:

    chown -R 100:101 ~/.edgemicro/ 
    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

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

      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
      

    লগ ফাইল আউটপুট বিকল্প নির্দিষ্ট করা হচ্ছে

    Edge Microgateway কনফিগারেশন প্যারামিটার to_console আপনাকে লগ ফাইলের পরিবর্তে স্ট্যান্ডার্ড আউটপুটে লগ তথ্য পাঠানোর বিকল্প বেছে নিতে দেয়। আপনি যদি Docker কন্টেনারে Edge Microgateway চালানোর ধাপগুলি অনুসরণ করেন, তাহলে কন্টেনারটি ডিফল্টভাবে stdout এবং ত্রুটি আউটপুটকে কন্টেনারে অবস্থিত একটি ফাইলে রিডাইরেক্ট করে: ${APIGEE_ROOT}/logs/edgemicro.log।

    edgemicro.log-এ লগ সংক্রান্ত তথ্য পাঠানো বন্ধ করতে, কন্টেনার চালানোর সময় LOG_CONSOLE_OUTPUT_TO_FILE ভেরিয়েবল ব্যবহার করুন।

    to_console-এর সাথে LOG_CONSOLE_OUTPUT_TO_FILE ব্যবহার করলে লগ আউটপুট কেমন হবে তা নিম্নলিখিত সারণীতে বর্ণনা করা হয়েছে:

    to_console: true

    LOG_CONSOLE_OUTPUT_TO_FILE=false

    • লগ ফাইল ম্যানেজ করা বিভাগে যেমন বর্ণনা করা হয়েছে, সেই অনুযায়ী Edge Microgateway লগ ফাইলে কোনও লগ পাঠানো হবে না।
    • edgemicro.log ফাইলে লগ পাঠানো হবে না।
    to_console: true

    LOG_CONSOLE_OUTPUT_TO_FILE=true

    • লগ ফাইল ম্যানেজ করা বিভাগে যেমন বর্ণনা করা হয়েছে, সেই অনুযায়ী Edge Microgateway লগ ফাইলে কোনও লগ পাঠানো হবে না।
    • edgemicro.log ফাইলে লগ পাঠানো হবে।
    to_console: false

    LOG_CONSOLE_OUTPUT_TO_FILE=true

    • লগ ফাইল ম্যানেজ করা বিভাগে যেভাবে বর্ণনা করা হয়েছে, সেই অনুযায়ী লগ Edge Microgateway লগ ফাইলে পাঠানো হবে।
    • edgemicro.log ফাইলে লগ পাঠানো হবে।

    API কল টেস্ট করা হচ্ছে

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

    http://localhost:8000/hello

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

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

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

    সঠিক API key দিয়ে API টেস্ট করা

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

    নিচে উল্লেখ করা পদ্ধতি অনুযায়ী x-api-key হেডার সহ API কল করুন। Developer App থেকে কপি করা কনজিউমার কী-এর ভ্যালু হল API key। সাধারণত, 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 কীভাবে কনফিগার করতে হয় তা ব্যাখ্যা করা হয়েছে। আপনি ইনকামিং অনুরোধের (নর্থবাউন্ড ডিরেকশন) জন্য TLS ব্যবহার করতে Edge Microgateway সার্ভার কনফিগার করতে পারেন এবং টার্গেট এন্ডপয়েন্টে (সাউথবাউন্ড ডিরেকশন) আউটগোয়িং অনুরোধের জন্য TLS ক্লায়েন্ট হিসেবে Edge Microgateway কনফিগার করতে পারেন।

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

    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 কনফিগার করতে হয় উদাহরণ দেখুন।

    যেমন:

    chown -R 100:101 ~/.edgemicro/ \
    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. https://github.com/apigee-internal/microgateway থেকে Edge 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 বিকল্পটি উল্লেখ করুন। যেমন:

    chown -R 100:101 ~/.edgemicro/ \
    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 কানেকশন সেট-আপ করতে হয় তা ব্যাখ্যা করা হয়েছে। Northbound 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. ব্যাশ ফাইলে, openssl.cnf ফাইলের পাথ সঠিক কিনা তা নিশ্চিত করুন।

    4. ব্যাশ ফাইল এক্সিকিউট করুন। আপনাকে সার্টিফিকেট সংক্রান্ত তথ্য দিতে বলা হবে। সাধারণ নামের জন্য 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 কন্টেনার রান করতে এই কমান্ডটি এক্সিকিউট করুন:

      chown -R 100:101 ~/.edgemicro/ \
      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. কমান্ডে ব্যবহার করা নিম্নলিখিত প্যারামিটারগুলি লক্ষ্য করুন; এগুলি ডকার কন্টেনার হিসেবে Edge Micro রান করুন-এ বর্ণিত প্রাথমিক কমান্ড থেকে আলাদা।

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

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

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

      curl -v https://localhost:8443/hello --cacert rootca.pem \
      -H "x-api-key: Az82fdnfONVCOOE4NKhajxAboDgA3FAo"
      
    2. ভার্বোস 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. ব্যাশ ফাইলে, openssl.cnf ফাইলের পাথ সঠিক কিনা তা নিশ্চিত করুন।

    4. ব্যাশ ফাইল এক্সিকিউট করুন। আপনাকে সার্টিফিকেট সংক্রান্ত তথ্য দিতে বলা হবে। সাধারণ নামের জন্য 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 চালু করতে নিম্নলিখিত কমান্ড রান করুন।

      chown -R 100:101 ~/.edgemicro/ \
      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-এ তৈরি করা ডেভেলপার অ্যাপ থেকে পাওয়া 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 ভেরিয়েবল যোগ করুন।

      chown -R 100:101 ~/.edgemicro/ \
      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 কমান্ডটি এক্সিকিউট করুন। আগের মতো আপনার বেসপাথ ও 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-এ ম্যাপ করা হয়েছে:

      chown -R 100:101 ~/.edgemicro/ \
      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 [শেয়ার করা ফাইলসিস্টেম] দেখুন।

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

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

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

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

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

      plugin
        |
        |-- plugins
          |
          |- response-uppercase
          |     |- index.js
          |     |- package.json
          |- request-headers
          |     | - index.js
                | - package.json
      
    3. plugin ফোল্ডারে cd।

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

      zip -r plugins.zip plugins/

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

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

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

      FROM gcr.io/apigee-microgateway/edgemicro:latest
      USER root
      RUN apt-get update && \
          apt-get install -y unzip && \
          rm -rf /var/lib/apt/lists/* && \
          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 ["/opt/apigee/entrypoint.sh"]
      
    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 রান করুন। কমান্ডটি বেশ কয়েকটি এনভায়রনমেন্ট ভেরিয়েবল সেট করে যা এজ মাইক্রোগেটওয়ে শুরু করার জন্য কন্টেইনার রানটাইম দ্বারা ব্যবহৃত হয়:

      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!