Express Link-এর মাধ্যমে Cloud Run-এর এক পরিষেবা থেকে অন্য পরিষেবায় অথেন্টিকেশন সহজ করা

১. এক নজরে

আপনি Cloud Run-এ মাইক্রোসার্ভিস বা মাল্টি-এজেন্ট অ্যাপ্লিকেশন তৈরি করলে, ইন্টার্নাল ব্যাকএন্ড পরিষেবা পাবলিক ইন্টারনেটের জন্য খোলা থাকা উচিত নয়। পরিবর্তে, আপনি প্রতিটি ব্যাকএন্ড পরিষেবা কনফিগার করেন যাতে যাচাইকরণ (--no-allow-unauthenticated) প্রয়োজন হয় এবং শুধুমাত্র অনুমোদিত কলারদের Cloud Run Invoker (roles/run.invoker) IAM ভূমিকা প্রদান করেন।

সাধারণত, যাচাই করা Cloud Run পরিষেবা কল করার জন্য আপনার কলিং অ্যাপ্লিকেশনকে কোডে ম্যানুয়াল টোকেন ইনজেকশন করতে হয়। HTTP অনুরোধ পাঠানোর আগে, আপনার কোড Google-স্বাক্ষরিত OpenID Connect (OIDC) ID টোকেনের জন্য Compute মেটাডেটা সার্ভারকে কোয়েরি করে। সেই টোকেনটি গন্তব্য পরিষেবার দর্শক URL-এ স্কোপ করা হয় এবং আপনার কোড এটিকে Authorization: Bearer হেডারে অ্যাটাচ করে। অ্যাপ্লিকেশন কোডের মধ্যে যাচাইকরণ প্লাম্বিং লেখা এবং রক্ষণাবেক্ষণ করা অপ্রয়োজনীয় ঘর্ষণ সৃষ্টি করে:

  • এটি আপনার ব্যবসার লজিককে Google Cloud যাচাইকরণ লাইব্রেরির সাথে যুক্ত করে, যা বিভিন্ন এনভায়রনমেন্ট জুড়ে রিডেবিলিটি এবং পোর্টেবিলিটি কমিয়ে দেয়।
  • টোকেন অ্যাকুইজিশন লজিক গন্তব্যের ধরন এবং নিরাপত্তা মোড জুড়ে পরিবর্তিত হয়। যেমন, Cloud Run-এর জন্য OIDC ID টোকেন, Google API-এর জন্য OAuth 2.0 অ্যাক্সেস টোকেন এবং mTLS-এর জন্য বাউন্ড টোকেন প্রয়োজন।

Cloud Run Express Link (প্রিভিউ) আপনার অ্যাপ্লিকেশন কোড থেকে ম্যানুয়াল টোকেন ইনজেকশন সরিয়ে দেয়। আপনি কলিং (সোর্স) Cloud Run পরিষেবায় অ্যাম্বিয়েন্ট নেটওয়ার্কিং চালু করেন এবং একটি ডিক্লারেটিভ ExpressLink রিসোর্স তৈরি করেন যা সোর্স পরিষেবাকে ডেস্টিনেশন পরিষেবার সাথে বাইন্ড করে। Google-এর ম্যানেজ করা সাইডকার প্রক্সি, গন্তব্যে পাঠানো আউটবাউন্ড প্লেইনটেক্সট HTTP অনুরোধ ইন্টারসেপ্ট করে, কলার পরিষেবার আইডেন্টিটি টোকেন অটোমেটিক ইনজেক্ট করে এবং গন্তব্যের সাথে কানেকশন এনক্রিপ্ট করে।

এই কোডল্যাবে, আপনি একই প্রাইভেট ব্যাকএন্ড পরিষেবার সাথে দুটি পদ্ধতিই তুলনা করবেন:

  1. একটি প্রাইভেট ডেস্টিনেশন পরিষেবা এবং একটি কলার পরিষেবা (caller-oidc) ডিপ্লয় করুন যা Python-এ Compute মেটাডেটা সার্ভার থেকে একটি OIDC ID টোকেন নিয়ে আসে। এই ধাপটি ব্যাকএন্ডে এন্ড-টু-এন্ড কানেক্টিভিটি কনফার্ম করে এবং এক্সপ্রেস লিঙ্ক ছাড়াই প্রয়োজনীয় যাচাইকরণ কোড দেখায়।
  2. মেটাডেটা টোকেন-ফেচিং কোড সরিয়ে দিয়ে দ্বিতীয় কলার পরিষেবা (caller-express-link) ডেপ্লয় করুন এবং অ্যাম্বিয়েন্ট নেটওয়ার্কিং ও এক্সপ্রেস লিঙ্ক ব্যবহার করে এটি গন্তব্য পরিষেবার সাথে কানেক্ট করুন।
PART 1: WITHOUT EXPRESS LINK (caller-oidc)
+----------------------------------------------+          +-----------------+
| Caller Service (caller-oidc)                 |  HTTPS   | Destination     |
|                                              | + token  | (destination)   |
|  App Container                               | -------> |                 |
|   1. Parse audience URL with urllib.parse    |          | Verifies caller |
|   2. Fetch OIDC ID token via google-auth     |          | has IAM role    |
|   3. Set Authorization: Bearer header        |          | run.invoker     |
+----------------------------------------------+          +-----------------+

PART 2: WITH EXPRESS LINK (caller-express-link)
+----------------------------------------------+          +-----------------+
| Caller Service (caller-express-link)         |  HTTPS   | Destination     |
|  +----------------+      +----------------+  | + token  | (destination)   |
|  | App Container  | HTTP | Ambient        |  | -------> |                 |
|  | requests.get() | ---> | Sidecar Proxy  |  |          | Same service    |
|  | (no auth code) |      | (Express Link) |  |          | as Part 1       |
|  +----------------+      +----------------+  |          | (unchanged)     |
+----------------------------------------------+          +-----------------+

পূর্বশর্ত

  • Python এবং HTTP ওয়েব সার্ভিস সম্পর্কে প্রাথমিক ধারণা
  • Google Cloud IAM পরিষেবা অ্যাকাউন্ট এবং Cloud Run ডিপ্লয়মেন্ট সম্পর্কে প্রাথমিক ধারণা

আপনি কী শিখবেন

  • কীভাবে একটি প্রাইভেট Cloud Run ডেস্টিনেশন পরিষেবা ডিপ্লয় করবেন যা IAM যাচাইকরণ এনফোর্স করে
  • বেসলাইন কানেক্টিভিটি যাচাই করার জন্য মেটাডেটা সার্ভার থেকে google-auth OIDC ID টোকেন ব্যবহার করে Python-এ কীভাবে ম্যানুয়ালি পরিষেবা-থেকে-পরিষেবা অনুরোধ যাচাই করতে হয়
  • কীভাবে ম্যানুয়াল টোকেন-ফেচিং কোড সরাবেন এবং Ambient Networking চালু করে Cloud Run কলার পরিষেবা ডিপ্লয় করবেন
  • কীভাবে Cloud Run এক্সপ্রেস লিঙ্ক তৈরি করবেন যাতে আপনার কলার পরিষেবা কোনও যাচাইকরণ কোড ছাড়াই একটি যাচাইকৃত গন্তব্য পরিষেবা চালু করতে পারে

আপনি কী তৈরি করবেন

  • গন্তব্য: Cloud Run-এ একটি ব্যক্তিগত Python Flask পরিষেবা যা একটি /ping এন্ডপয়েন্ট প্রকাশ করে
  • caller-oidc: একটি Python Flask পরিষেবা যা অ্যাপ্লিকেশন কোডে ম্যানুয়ালি OIDC ID টোকেন ফেচ ও ইনজেক্ট করার মাধ্যমে destination কল করে
  • caller-express-link: জিরো টোকেন-ইনজেকশন কোড সহ পাশাপাশি Python Flask পরিষেবা যা এক্সপ্রেস লিঙ্কের মাধ্যমে একই গন্তব্য পরিষেবা কল করে

আপনার কী প্রয়োজন হবে

  • Chrome-এর মতো ওয়েব ব্রাউজার
  • বিলিং চালু করা এবং IAM পরিষেবা অ্যাকাউন্ট, Cloud Run পরিষেবা ও নেটওয়ার্ক পরিষেবা রিসোর্স তৈরি করার অনুমতি সহ Google Cloud প্রোজেক্ট

২. আপনার পরিবেশ সেট-আপ করুন

Google Cloud প্রোজেক্ট সেট-আপ করা

  1. আপনার আগে থেকে কোনও Google অ্যাকাউন্ট না থাকলে, আপনাকে অবশ্যই একটি Google অ্যাকাউন্ট তৈরি করতে হবে।
    • অফিস বা স্কুলের অ্যাকাউন্টের পরিবর্তে ব্যক্তিগত অ্যাকাউন্ট ব্যবহার করুন। অফিস ও স্কুলের অ্যাকাউন্টে বিধিনিষেধ থাকতে পারে যা আপনাকে এই ল্যাবের জন্য প্রয়োজনীয় API চালু করতে বাধা দেয়।
  2. Google Cloud Console-এ সাইন-ইন করুন।
  3. Cloud Console-এ বিলিং চালু করুন।
    • এই ল্যাব সম্পূর্ণ করতে Cloud রিসোর্সে $১ মার্কিন ডলারের কম খরচ হওয়া উচিত।
    • আরও চার্জ এড়াতে রিসোর্স মুছে ফেলতে আপনি এই ল্যাবের শেষে উল্লেখ করা ধাপগুলি অনুসরণ করতে পারেন।
    • নতুন ব্যবহারকারীরা $৩০০ মার্কিন ডলারের ফ্রি ট্রায়াল-এর জন্য উপযুক্ত।
  4. নতুন প্রোজেক্ট তৈরি করুন অথবা আগে থেকে থাকা প্রোজেক্ট আবার ব্যবহার করার বিকল্প বেছে নিন।
    • প্রোজেক্ট কোটা সম্পর্কে কোনও সমস্যা দেখতে পেলে, আগে থেকে আছে এমন কোনও প্রোজেক্ট আবার ব্যবহার করুন অথবা নতুন প্রোজেক্ট তৈরি করতে আগে থেকে আছে এমন কোনও প্রোজেক্ট মুছে দিন।

Cloud Shell চালু করুন

এই কোডল্যাবে, আপনি Cloud Shell ব্যবহার করবেন, এটি হল ব্রাউজার-ভিত্তিক কমান্ড-লাইন এনভায়রনমেন্ট যা Google Cloud CLI (gcloud), Python ও curl-এর সাথে আগে থেকেই ইনস্টল করা থাকে।

  1. Google Cloud কনসোলে, উপরের নেভিগেশন বারে Cloud Shell অ্যাক্টিভেট করুন বিকল্পে ক্লিক করুন। প্রম্পট করা হলে, অনুমোদন করুন বিকল্পে ক্লিক করুন।
  2. আপনার প্রোজেক্ট আইডি ও ডিপ্লয়মেন্ট অঞ্চল এক্সপোর্ট করুন এবং $PROJECT_ID ব্যবহার করার জন্য gcloud কনফিগার করুন। YOUR_PROJECT_ID-এর জায়গায় আপনার প্রোজেক্ট আইডি লিখুন এবং বিকল্প হিসেবে us-west1-এর জায়গায় অন্য Cloud Run অঞ্চল লিখুন:
export PROJECT_ID="YOUR_PROJECT_ID"
export REGION="us-west1"
gcloud config set project "$PROJECT_ID"
  1. আপনার প্রোজেক্ট নম্বর ও অ্যাক্টিভ Google Cloud অ্যাকাউন্ট এক্সপোর্ট করুন এবং কনফার্ম করুন যে চারটি ভেরিয়েবলই পূরণ করা হয়েছে:
export PROJECT_NUMBER=$(gcloud projects describe "$PROJECT_ID" --format="value(projectNumber)")
export ACTIVE_ACCOUNT=$(gcloud config get-value account 2>/dev/null)
echo "PROJECT_ID: $PROJECT_ID | PROJECT_NUMBER: $PROJECT_NUMBER | ACCOUNT: $ACTIVE_ACCOUNT | REGION: $REGION"

gcloud আপডেট করুন এবং API চালু করুন

  1. আপনার gcloud কম্পোনেন্ট আপডেট করুন যাতে আপনার কাছে অ্যাম্বিয়েন্ট নেটওয়ার্কিং ও এক্সপ্রেস লিঙ্কের জন্য লেটেস্ট beta কমান্ড থাকে:
gcloud components update --quiet
  1. Cloud Run সোর্স ডিপ্লয়মেন্ট, IAM পরিষেবা অ্যাকাউন্ট, অ্যাম্বিয়েন্ট নেটওয়ার্কিং ও নেটওয়ার্ক সার্ভিসেস এক্সপ্রেস লিঙ্কের জন্য প্রয়োজনীয় Google Cloud API চালু করুন:
gcloud services enable \
    iam.googleapis.com \
    run.googleapis.com \
    cloudbuild.googleapis.com \
    artifactregistry.googleapis.com \
    networkservices.googleapis.com \
    networksecurity.googleapis.com \
    trafficdirector.googleapis.com \
    cloudtrace.googleapis.com

ওয়ার্কস্পেস ডিরেক্টরি তৈরি করা

এই কোডল্যাবে আপনি যে তিনটি পরিষেবা ফোল্ডার তৈরি করবেন সেগুলি রাখার জন্য একটি ওয়ার্কিং ডিরেক্টরি তৈরি করুন:

mkdir -p ~/express-link-codelab
cd ~/express-link-codelab

৩. প্রাইভেট ডেস্টিনেশন পরিষেবা ডেপ্লয় করুন

প্রথমে, আপনি destination নামের একটি প্রাইভেট Cloud Run সার্ভিস ডিপ্লয় করবেন। আপনি কোডল্যাবের দুটি অংশের জন্যই এই একক গন্তব্য পরিষেবাটি আবার ব্যবহার করবেন:

  • গন্তব্য পরিষেবা কখনও আউটবাউন্ড টোকেন ইনজেকশন করে না।
  • Express Link-এর মাধ্যমে ট্রাফিক পাওয়ার জন্য ডেস্টিনেশন পরিষেবায় অ্যাম্বিয়েন্ট নেটওয়ার্কিং চালু করার প্রয়োজন নেই।
  1. ডেস্টিনেশন পরিষেবার জন্য একটি ডেডিকেটেড IAM পরিষেবা অ্যাকাউন্ট তৈরি করুন:
gcloud iam service-accounts create destination-identity \
    --display-name="Cloud Run destination service account"
  1. destination ফোল্ডার তৈরি করে তাতে সরান:
mkdir -p ~/express-link-codelab/destination
cd ~/express-link-codelab/destination
  1. Flask ও Gunicorn-এর সাহায্যে requirements.txt ফাইল তৈরি করতে নিম্নলিখিত কমান্ড রান করুন:
cat << 'EOF' > requirements.txt
Flask==3.0.0
gunicorn==21.2.0
EOF
  1. K_SERVICE এনভায়রনমেন্ট ভেরিয়েবেল থেকে Cloud Run পরিষেবার নাম ফিরিয়ে এনে /ping এন্ডপয়েন্ট প্রকাশ করে এমন একটি main.py ফাইল তৈরি করতে নিম্নলিখিত কমান্ড রান করুন:
cat << 'EOF' > main.py
import os
from flask import Flask

app = Flask(__name__)

@app.route("/ping")
def ping():
    service_name = os.environ.get("K_SERVICE", "unknown")
    return f"Hello from {service_name}"

if __name__ == "__main__":
    app.run(host="0.0.0.0", port=int(os.environ.get("PORT", 8080)))
EOF
  1. --no-allow-unauthenticated-এর মাধ্যমে সোর্স থেকে destination ডিপ্লয় করুন যাতে Cloud Run যাচাই না করা অনুরোধ বাতিল করে দেয়:
gcloud run deploy destination \
    --source . \
    --region="$REGION" \
    --service-account="destination-identity@${PROJECT_ID}.iam.gserviceaccount.com" \
    --no-allow-unauthenticated
  1. এনভায়রনমেন্ট ভেরিয়েবলে ডেস্টিনেশন পরিষেবার ডিটারমিনিস্টিক URL ও সম্পূর্ণ রিসোর্স URI স্টোর করুন:
export DESTINATION_URL="https://destination-${PROJECT_NUMBER}.${REGION}.run.app"
export DESTINATION_URI="//run.googleapis.com/projects/${PROJECT_NUMBER}/locations/${REGION}/services/destination"
echo "DESTINATION_URL: $DESTINATION_URL"
echo "DESTINATION_URI: $DESTINATION_URI"
  1. আপনার ব্যবহারকারীর অ্যাকাউন্টকে destination-এ Cloud Run Invoker (roles/run.invoker) ভূমিকা দিন যাতে আপনি সরাসরি Cloud Shell থেকে এটি পরীক্ষা করতে পারেন:
gcloud run services add-iam-policy-binding destination \
    --member="user:$ACTIVE_ACCOUNT" \
    --role="roles/run.invoker" \
    --region="$REGION"
  1. destination চলছে কিনা তা কনফার্ম করতে আপনার নিজের পরিচয় টোকেন ব্যবহার করে /ping-এ একটি যাচাই করা অনুরোধ পাঠান:
TOKEN=$(gcloud auth print-identity-token)
curl -H "Authorization: Bearer $TOKEN" "$DESTINATION_URL/ping"

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

Hello from destination

৪. Express Link ছাড়াই গন্তব্যে কল করুন

Express Link চালু করার আগে, caller-oidc তৈরি করুন যাতে দেখতে পারেন যে বর্তমানে পরিষেবা-থেকে-পরিষেবা যাচাইকরণের জন্য কী কী প্রয়োজন এবং যাচাই করুন যে কলিং পরিষেবা destination-এ পৌঁছাতে পারে কিনা। Express Link ছাড়া নিরাপদে destination কল করতে, আপনাকে দুটি লেয়ার কনফিগার করতে হবে:

  • IAM অনুমোদন: destination-এ caller-oidc পরিষেবা অ্যাকাউন্টকে roles/run.invoker ভূমিকা দিন।
  • অ্যাপ্লিকেশন-লেভেল টোকেন ইনজেকশন: caller-oidc-এ google-auth লাইব্রেরি যোগ করুন এবং রুট OIDC অডিয়েন্স এক্সট্র্যাক্ট করতে টার্গেট URL পার্স করুন। তারপর মেটাডেটা সার্ভার থেকে একটি স্বাক্ষরিত আইডি টোকেন আনুন এবং আউটবাউন্ড HTTPS অনুরোধে Authorization: Bearer ID_TOKEN অ্যাটাচ করুন।

caller-oidc কনফিগার ও ডিপ্লয় করতে এইসব ধাপ অনুসরণ করুন:

  1. caller-oidc-এর জন্য একটি নির্দিষ্ট পরিষেবা অ্যাকাউন্ট তৈরি করুন:
gcloud iam service-accounts create caller-oidc-identity \
    --display-name="Cloud Run OIDC caller service account"
  1. destination চালু করার জন্য caller-oidc-identity-কে অনুমতি দিন:
gcloud run services add-iam-policy-binding destination \
    --member="serviceAccount:caller-oidc-identity@${PROJECT_ID}.iam.gserviceaccount.com" \
    --role="roles/run.invoker" \
    --region="$REGION"
  1. destination-এর পাশাপাশি caller-oidc ডিরেক্টরি তৈরি করুন:
mkdir -p ~/express-link-codelab/caller-oidc
cd ~/express-link-codelab/caller-oidc
  1. requirements.txt ফাইল তৈরি করতে এই কমান্ড রান করুন। মনে রাখবেন, আপনার অ্যাপ্লিকেশন কন্টেনারে টোকেন রিট্রিভাল ম্যানেজ করার জন্য আপনাকে অবশ্যই google-auth যোগ করতে হবে:
cat << 'EOF' > requirements.txt
Flask==3.0.0
google-auth==2.23.0
requests==2.31.0
gunicorn==21.2.0
EOF
  1. ম্যানুয়াল OIDC টোকেন ইনজেকশন সহ main.py ফাইল তৈরি করতে এই কমান্ড রান করুন:
cat << 'EOF' > main.py
import os
from urllib.parse import urlparse
from flask import Flask, request
from google.auth.transport.requests import Request as GoogleAuthRequest
from google.oauth2 import id_token
import requests

app = Flask(__name__)

@app.route("/ping")
def ping():
    service_name = os.environ.get("K_SERVICE", "unknown")
    return f"Hello from {service_name}"

@app.route("/")
def call_destination():
    target_url = request.args.get("target_url")
    if not target_url:
        return "Error: target_url query parameter not set.", 400

    try:
        # 1. Extract the root service URL (scheme + host) for the OIDC audience claim
        parsed_url = urlparse(target_url)
        target_audience = f"{parsed_url.scheme}://{parsed_url.netloc}"

        # 2. Fetch a Google-signed OIDC ID token from the metadata server
        auth_req = GoogleAuthRequest()
        token = id_token.fetch_id_token(auth_req, target_audience)

        # 3. Inject the token as an HTTP Bearer header
        headers = {"Authorization": f"Bearer {token}"}
        response = requests.get(target_url, headers=headers, timeout=10)
        return f"I called the destination and it replied: '{response.text}'"
    except Exception as e:
        return f"Error calling destination: {str(e)}", 500

if __name__ == "__main__":
    app.run(host="0.0.0.0", port=int(os.environ.get("PORT", 8080)))
EOF
  1. Cloud Run-এ caller-oidc ডিপ্লয় করুন:
gcloud run deploy caller-oidc \
    --source . \
    --region="$REGION" \
    --service-account="caller-oidc-identity@${PROJECT_ID}.iam.gserviceaccount.com" \
    --no-allow-unauthenticated
  1. caller-oidc চালু করার জন্য আপনার ব্যবহারকারীর অ্যাকাউন্টকে অনুমতি দিন:
gcloud run services add-iam-policy-binding caller-oidc \
    --member="user:$ACTIVE_ACCOUNT" \
    --role="roles/run.invoker" \
    --region="$REGION"
  1. caller-oidc-এর নির্ধারক URL স্টোর করুন এবং target_url হিসেবে HTTPS URL $DESTINATION_URL/ping পাস করে এটি চালু করুন:
export CALLER_OIDC_URL="https://caller-oidc-${PROJECT_NUMBER}.${REGION}.run.app"
TOKEN=$(gcloud auth print-identity-token)
curl -H "Authorization: Bearer $TOKEN" "$CALLER_OIDC_URL/?target_url=$DESTINATION_URL/ping"

destination থেকে আপনার উত্তর পাওয়ার কথা:

I called the destination and it replied: 'Hello from destination'

৫. Express Link-এর জন্য কলার পরিষেবা ডিপ্লয় করুন

এখন আপনি একটি সিবলিং ডিরেক্টরিতে caller-express-link নামের একটি দ্বিতীয় কলার পরিষেবা তৈরি করবেন। Express Link-এর মাধ্যমে, caller-express-link-এর কোনও টোকেন-ইনজেকশন কোড প্রয়োজন হয় না—এটি সরাসরি requests.get(target_url, timeout=10)-কে কল করে।

  1. caller-express-link-এর জন্য একটি নির্দিষ্ট পরিষেবা অ্যাকাউন্ট তৈরি করুন:
gcloud iam service-accounts create caller-express-link-identity \
    --display-name="Cloud Run Express Link caller service account"
  1. caller-express-link-identity-কে roles/trafficdirector.client ভূমিকা দিন যাতে ম্যানেজ করা অ্যাম্বিয়েন্ট নেটওয়ার্কিং সাইডকার এক্সপ্রেস লিঙ্ক রাউটিং এবং নিরাপত্তা কনফিগারেশন ডাউনলোড করতে পারে। এছাড়াও, roles/cloudtrace.agent-কে অনুমতি দিন যাতে সাইডকার ট্রেস স্প্যান এক্সপোর্ট করতে পারে:
gcloud projects add-iam-policy-binding "$PROJECT_ID" \
    --member="serviceAccount:caller-express-link-identity@${PROJECT_ID}.iam.gserviceaccount.com" \
    --role="roles/trafficdirector.client"

gcloud projects add-iam-policy-binding "$PROJECT_ID" \
    --member="serviceAccount:caller-express-link-identity@${PROJECT_ID}.iam.gserviceaccount.com" \
    --role="roles/cloudtrace.agent"
  1. caller-oidc-এর পাশাপাশি caller-express-link ডিরেক্টরি তৈরি করুন:
mkdir -p ~/express-link-codelab/caller-express-link
cd ~/express-link-codelab/caller-express-link
  1. google-auth ছাড়া requirements.txt ফাইল তৈরি করতে নিম্নলিখিত কমান্ড রান করুন:
cat << 'EOF' > requirements.txt
Flask==3.0.0
requests==2.31.0
gunicorn==21.2.0
EOF
  1. কোনও টোকেন-ইনজেকশন লজিক ছাড়া এবং সাধারণ requests.get(target_url, timeout=10) কল সহ main.py ফাইল তৈরি করতে নিম্নলিখিত কমান্ড রান করুন:
cat << 'EOF' > main.py
import os
from flask import Flask, request
import requests

app = Flask(__name__)

@app.route("/ping")
def ping():
    service_name = os.environ.get("K_SERVICE", "unknown")
    return f"Hello from {service_name}"

@app.route("/")
def call_destination():
    target_url = request.args.get("target_url")
    if not target_url:
        return "Error: target_url query parameter not set.", 400

    try:
        response = requests.get(target_url, timeout=10)
        return f"I called the destination and it replied: '{response.text}'"
    except Exception as e:
        return f"Error calling destination: {str(e)}", 500

if __name__ == "__main__":
    app.run(host="0.0.0.0", port=int(os.environ.get("PORT", 8080)))
EOF
  1. আপনি যে যাচাইকরণ বয়লারপ্লেট বাদ দিয়েছেন তা দেখতে ../caller-oidc/main.py-এর বিপরীতে diff রান করুন:
diff -u ../caller-oidc/main.py main.py || true
  1. --ambient-networking ও --ambient-scope=global চালু রেখে gcloud beta run deploy ব্যবহার করে caller-express-link ডিপ্লয় করুন:
gcloud beta run deploy caller-express-link \
    --source . \
    --region="$REGION" \
    --service-account="caller-express-link-identity@${PROJECT_ID}.iam.gserviceaccount.com" \
    --no-allow-unauthenticated \
    --ambient-networking \
    --ambient-scope=global
  1. caller-express-link-এ অ্যাম্বিয়েন্ট নেটওয়ার্কিং চালু আছে কিনা তা যাচাই করুন:
gcloud run services describe caller-express-link --region="$REGION"

সংশোধনের সারসংক্ষেপের শেষে, Ambient Networking এবং Ambient Scope দেখা যাচ্ছে কিনা তা যাচাই করুন:

  Ambient Networking: Enabled
  Ambient Scope:     global
  1. caller-express-link-কে ইনভোক করার জন্য আপনার ব্যবহারকারীর অ্যাকাউন্টকে অনুমতি দিন এবং destination-কে ইনভোক করার জন্য caller-express-link-identity-কে অনুমোদন দিন:
gcloud run services add-iam-policy-binding caller-express-link \
    --member="user:$ACTIVE_ACCOUNT" \
    --role="roles/run.invoker" \
    --region="$REGION"

gcloud run services add-iam-policy-binding destination \
    --member="serviceAccount:caller-express-link-identity@${PROJECT_ID}.iam.gserviceaccount.com" \
    --role="roles/run.invoker" \
    --region="$REGION"
  1. destination-এর HTTP (http://) নির্ধারক URL-এর সাথে caller-express-link-এর URL এবং রিসোর্স URI স্টোর করুন:
export CALLER_EL_URL="https://caller-express-link-${PROJECT_NUMBER}.${REGION}.run.app"
export CALLER_EL_URI="//run.googleapis.com/projects/${PROJECT_NUMBER}/locations/${REGION}/services/caller-express-link"
export DESTINATION_HTTP_URL="http://destination-${PROJECT_NUMBER}.${REGION}.run.app"
echo "CALLER_EL_URL: $CALLER_EL_URL"
echo "CALLER_EL_URI: $CALLER_EL_URI"
echo "DESTINATION_HTTP_URL: $DESTINATION_HTTP_URL"
  1. এক্সপ্রেস লিঙ্ক তৈরি করার আগে caller-express-link-এর মাধ্যমে destination-এ কল করে টেস্ট করুন:
TOKEN=$(gcloud auth print-identity-token)
curl -H "Authorization: Bearer $TOKEN" "$CALLER_EL_URL/?target_url=$DESTINATION_HTTP_URL/ping"

প্রত্যাশিতভাবে, 403 Forbidden-এর সাথে কলটি ব্যর্থ হয় কারণ অনুরোধটি ইন্টারসেপ্ট করতে এবং ক্রেডেনশিয়াল ইনজেক্ট করার জন্য এখনও কোনও এক্সপ্রেস লিঙ্ক নেই:

I called the destination and it replied: '
<html><head>
<meta http-equiv="content-type" content="text/html;charset=utf-8">
<title>403 Forbidden</title>
</head>
<body text=#000000 bgcolor=#ffffff>
<h1>Error: Forbidden</h1>
<h2>Your client does not have permission to get URL <code>/ping</code> from this server.</h2>
<h2></h2>
</body></html>
'

৬. এক্সপ্রেস লিঙ্কের মাধ্যমে পরিষেবাগুলি কানেক্ট করুন

এখন আপনি ExpressLink রিসোর্স ঘোষণা করবেন যা caller-express-link (সোর্স পরিষেবা) থেকে destination-এর সাথে কানেক্ট করবে—কোনও কোড পরিবর্তন না করে বা কোনও Cloud Run পরিষেবা আবার ডিপ্লয় না করে।

  1. global লোকেশনে এক্সপ্রেস লিঙ্ক রিসোর্স তৈরি করুন:
gcloud beta network-services express-links create caller-to-destination \
    --location=global \
    --description="Express Link from caller-express-link to destination" \
    --source-services="$CALLER_EL_URI" \
    --destination-services="$DESTINATION_URI"
  1. রিসোর্স আছে কিনা তা কনফার্ম করতে আপনার এক্সপ্রেস লিঙ্ক তালিকাভুক্ত করুন:
gcloud beta network-services express-links list --location=global

কমান্ড আউটপুট:

NAME
caller-to-destination
  1. Express Link কনফিগারেশনের বিবরণ দেখুন:
gcloud beta network-services express-links describe caller-to-destination --location=global

কমান্ড আউটপুট:

createTime: '2026-10-27T19:30:04.492105068Z'
description: Express Link from caller-express-link to destination
destination:
  services:
  - //run.googleapis.com/projects/PROJECT_NUMBER/locations/us-west1/services/destination
etag: ...
name: projects/PROJECT_ID/locations/global/expressLinks/caller-to-destination
source:
  services:
  - //run.googleapis.com/projects/PROJECT_NUMBER/locations/us-west1/services/caller-express-link
updateTime: '2026-10-27T19:30:11.309054865Z'
  1. caller-express-link-এর জন্য ঠিক একই curl অনুরোধ আবার রান করুন:
TOKEN=$(gcloud auth print-identity-token)
curl -H "Authorization: Bearer $TOKEN" "$CALLER_EL_URL/?target_url=$DESTINATION_HTTP_URL/ping"

এইবার, অ্যাম্বিয়েন্ট সাইডকার destination-এ HTTP অনুরোধ ইন্টারসেপ্ট করে, caller-express-link-identity-এর জন্য পরিচয় টোকেন ইনজেক্ট করে, কানেকশন TLS-এ আপগ্রেড করে এবং গন্তব্যের উত্তর ফেরত দেয়:

I called the destination and it replied: 'Hello from destination'

caller-oidc এবং caller-express-link-এর মধ্যে কী পরিবর্তন হয়েছে তা নিচের সারণীতে সংক্ষেপে দেওয়া হল:

আকার

Express Link ছাড়া (caller-oidc)

Express Link (caller-express-link) সহ

requirements.txt-এ Auth লাইব্রেরি

google-auth আবশ্যক

কোনওটিই নয় (শুধুমাত্র Flask, requests, gunicorn)

main.py-এ আউটবাউন্ড কল

অডিয়েন্স URL পার্স করুন, id_token.fetch_id_token() কল করুন, Authorization: Bearer হেডার অ্যাটাচ করুন

প্লেন requests.get(target_url, timeout=10)

অ্যাপে টার্গেট URL স্কিম

https://destination-PROJECT_NUMBER.REGION.run.app

http://destination-PROJECT_NUMBER.REGION.run.app (Ambient সাইডকার দ্বারা TLS-এ আপগ্রেড করা হয়েছে)

Caller Cloud Run কনফিগারেশন

স্ট্যান্ডার্ড ডিপ্লয়মেন্ট

কলার পরিষেবা অ্যাকাউন্টে --ambient-networking --ambient-scope=global + roles/trafficdirector.client

ডেস্টিনেশন Cloud Run কনফিগারেশন

--no-allow-unauthenticated + roles/run.invoker

অপরিবর্তিত (--no-allow-unauthenticated + roles/run.invoker)

৭. অপ্রয়োজনীয়গুলি মুছুন

আপনার Google Cloud অ্যাকাউন্টে চলমান চার্জ এড়াতে, এই কোডল্যাব চলাকালীন আপনার তৈরি করা রিসোর্সগুলি মুছে দিন।

  1. Express Link রিসোর্স মুছে দিন:
gcloud beta network-services express-links delete caller-to-destination --location=global --quiet
  1. তিনটি Cloud Run পরিষেবা মুছে দিন:
gcloud run services delete caller-express-link --region="$REGION" --quiet
gcloud run services delete caller-oidc --region="$REGION" --quiet
gcloud run services delete destination --region="$REGION" --quiet
  1. প্রোজেক্ট-লেভেল IAM নীতি বাইন্ডিং সরান এবং তিনটি পরিষেবা অ্যাকাউন্ট মুছে দিন:
gcloud projects remove-iam-policy-binding "$PROJECT_ID" \
    --member="serviceAccount:caller-express-link-identity@${PROJECT_ID}.iam.gserviceaccount.com" \
    --role="roles/trafficdirector.client" \
    --quiet

gcloud projects remove-iam-policy-binding "$PROJECT_ID" \
    --member="serviceAccount:caller-express-link-identity@${PROJECT_ID}.iam.gserviceaccount.com" \
    --role="roles/cloudtrace.agent" \
    --quiet

gcloud iam service-accounts delete "caller-express-link-identity@${PROJECT_ID}.iam.gserviceaccount.com" --quiet
gcloud iam service-accounts delete "caller-oidc-identity@${PROJECT_ID}.iam.gserviceaccount.com" --quiet
gcloud iam service-accounts delete "destination-identity@${PROJECT_ID}.iam.gserviceaccount.com" --quiet
  1. (ঐচ্ছিক) আপনি যদি এই কোডল্যাবের জন্য একটি ডেডিকেটেড Google Cloud প্রোজেক্ট তৈরি করে থাকেন, তাহলে আপনি পুরো প্রোজেক্টটি মুছে ফেলতে পারেন:
# Run only if you want to delete the entire project and all its resources
gcloud projects delete "$PROJECT_ID"

৮. অভিনন্দন

আপনি একটি প্রাইভেট Cloud Run ব্যাকএন্ড পরিষেবা ডিপ্লয় করেছেন এবং Python-এ ম্যানুয়াল OIDC টোকেন ইনজেকশন ব্যবহার করে এটি কল করেছেন। তারপর আপনি সব অ্যাপ্লিকেশন-লেভেল যাচাইকরণ কোডকে একটি ডিক্লারেটিভ Cloud Run Express Link দিয়ে পরিবর্তন করেছেন।

আপনি কী শিখেছেন

  • ম্যানুয়াল OIDC টোকেন ইনজেকশন কেন অ্যাপ্লিকেশন বিজনেস লজিককে প্ল্যাটফর্ম যাচাইকরণ লাইব্রেরি এবং নিরাপত্তা মোডের সাথে যুক্ত করে
  • Express Link সহ বা ছাড়া অপরিবর্তিতভাবে কাজ করে এমন যাচাই করা Cloud Run ডেস্টিনেশন পরিষেবা কীভাবে ডিপ্লয় করবেন
  • কলিং Cloud Run পরিষেবায় কীভাবে অ্যাম্বিয়েন্ট নেটওয়ার্কিং (--ambient-scope=global-এর সাথে --ambient-networking) চালু করবেন এবং ট্রাফিক ডিরেক্টর ক্লায়েন্টকে অনুমতি (roles/trafficdirector.client) দেবেন
  • কীভাবে নেটওয়ার্ক সার্ভিস ExpressLink রিসোর্স তৈরি ও পরীক্ষা করবেন যা অটোমেটিক পরিচয় টোকেন ইনজেক্ট করে এবং আপনার কন্টেনার থেকে এনক্রিপ্ট করা TLS কানেকশনে প্লেইনটেক্সট http:// কল আপগ্রেড করে

পরবর্তী ধাপ