gactions ব্যবহারকারী গাইড

এই নির্দেশিকা আপনাকে দেখায় কিভাবে সাধারণ ব্যবহারের পরিস্থিতিতে গ্যাকশন কমান্ড লাইন ইন্টারফেস (CLI) টুল ব্যবহার করতে হয়। বিল্ডিং অ্যাকশন এন্ড-টু-এন্ড সম্পর্কে তথ্যের জন্য, কথোপকথনমূলক অ্যাকশন বিল্ড ডকুমেন্টেশন দেখুন।

টিপ: কমান্ড চালানোর সময় আরও তথ্য দেখতে, --verbose পতাকা ব্যবহার করুন।

প্রকল্প সিঙ্ক্রোনাইজেশন

অ্যাকশন SDK ব্যবহার করার সময়, অ্যাকশন কনসোল এবং আপনার স্থানীয় ফাইল সিস্টেমের মধ্যে অ্যাকশন প্রকল্পগুলিকে সিঙ্ক্রোনাইজ করার জন্য গ্যাকশন হল আপনার টুল।

gactions pull অপারেশনগুলি অ্যাকশন কনসোল থেকে আপনার স্থানীয় ফাইল সিস্টেমে একটি প্রকল্প রপ্তানি করে এবং gactions push অপারেশনগুলি আপনার স্থানীয় ফাইল সিস্টেম থেকে অ্যাকশন কনসোলে একটি প্রকল্পকে ঠেলে দেয়।

অ্যাকশন কনসোল থেকে অ্যাকশন ডাউনলোড করুন

স্থানীয় ফাইল সিস্টেমে একটি অ্যাকশন প্রকল্পের কনফিগারেশন অনুলিপি করতে gactions pull চালান।

আপনি যে প্রকল্পটি কপি করতে চান তার project-id কমান্ড লাইনে পাস করা যেতে পারে, অথবা settings/settings.yaml ফাইলে লেখা যেতে পারে। উভয়ই উপস্থিত থাকলে, CLI একটি বিকল্প হিসাবে পাস করা মানকে অগ্রাধিকার দেয়।

mkdir -p myAction/sdk
cd myAction/sdk
gactions pull --project-id my-project-id
Pulling your project files from Draft for a project id: "my-project-id"
✔ Done. You should see the files written in path/to/myAction/sdk
ls -l
total 8
drwxr-x---  3 user  primarygroup   96 May  7 10:00 actions
drwxr-x---  4 user  primarygroup  128 May  7 10:00 custom
-rw-r-----  1 user  primarygroup   15 May  7 10:00 manifest.yaml
drwxr-x---  3 user  primarygroup   96 May  7 10:00 settings
vi settings/settings.yaml
// change projectId to "my-other-project-id"
gactions pull
Pulling your project files from Draft for a project id: "my-other-project-id"
path/to/myAction/sdk/manifest.yaml already exists. Would you like to overwrite it?. [y/n]
...
✔ Done. You should see the files written in path/to/myAction/sdk

উপরের কোড স্নিপেটটি দেখায় কিভাবে প্রকল্পের খসড়া থেকে একটি অ্যাকশন টানতে হয়। আপনার অ্যাকশনের একটি নির্দিষ্ট সংস্করণ থেকে টেনে আনাও সম্ভব। একটি সংস্করণ আপনার অ্যাকশন প্রকল্পের একটি জমা দেওয়া অনুলিপি উপস্থাপন করে, যা একটি রিলিজ চ্যানেলে স্থাপন করা যেতে পারে।

--version-id পতাকা কোন সংস্করণ টানতে হবে তা নির্দিষ্ট করে।

mkdir -p myAction/sdk
cd myAction/sdk
gactions pull --project-id my-project-id --version-id my-version-id
Pulling version "my-version-id" of the project "my-project-id" from Actions Console...
✔ Done. You should see the files written in path/to/myAction/sdk
ls -l
total 8
drwxr-x---  3 user  primarygroup   96 May  7 10:00 actions
drwxr-x---  4 user  primarygroup  128 May  7 10:00 custom
-rw-r-----  1 user  primarygroup   15 May  7 10:00 manifest.yaml
drwxr-x---  3 user  primarygroup   96 May  7 10:00 settings

আপনি নিশ্চিতকরণের জন্য জিজ্ঞাসা না করেই ফাইলের স্থানীয় কপিগুলি ওভাররাইট করতে চাইলে --force পতাকা ব্যবহার করুন। দূরবর্তী খসড়া বা সংস্করণে উপস্থিত নয় এমন স্থানীয় ফাইলগুলিকে অপসারণ করতে --clean পতাকা ব্যবহার করুন। অ্যাকশন কনসোল প্রকল্পের একটি সঠিক অনুলিপি পেতে তাদের একসাথে ব্যবহার করুন।

touch local_file.txt
gactions pull --force
Pulling your project files from Draft for a project id: "my-project-id"
[WARNING] 2020/05/07 17:34:32 path/to/myAction/sdk/local_file.txt is not present in the draft of your Action. To remove, run pull with --clean flag.
✔ Done. You should see the files written in path/to/myAction/sdk
gactions pull --force --clean
Pulling your project files from Draft for a project id: "my-project-id"
[WARNING] 2020/05/07 17:43:44 path/to/myAction/sdk/local_file.txt is not present in the draft of your Action. Removing path/to/myAction/sdk/local_file.txt.
✔ Done. You should see the files written in path/to/myAction/sdk

পুশ অ্যাকশন টু অ্যাকশন কনসোল প্রকল্পের খসড়া

স্থানীয় ফাইল সিস্টেম থেকে কনসোলে আপনার অ্যাকশনের খসড়াতে পরিবর্তনগুলি পুশ করতে gactions push চালান। পরীক্ষার জন্য পরিবেশিত সংস্করণটিকে প্রভাবিত না করে, অ্যাকশন কনসোলে আপনার পরিবর্তনগুলি প্রতিফলিত দেখতে বিকাশের সময় এই প্রক্রিয়াটি কার্যকর হতে পারে।

gactions push
Pushing your project files to your Actions console draft for a project id: "my-project-id". This may take a few minutes.
Sending configuration files
Waiting for server to respond.
✔ Done. You can now navigate to the Actions Console: https://console.actions.google.com/project/my-project-id/overview to view your project. If you want to test your changes in the simulator, run "gactions deploy preview"

একটি সোর্স কোড ম্যানেজমেন্ট সিস্টেম থেকে একটি বিদ্যমান প্রকল্প আমদানি করুন

আপনি যদি একটি সংস্করণ নিয়ন্ত্রণ সিস্টেমের একটি সংশোধন থেকে একটি বিদ্যমান প্রকল্পে কাজ করতে চান:

1. লক্ষ্য সংশোধন পরীক্ষা করে দেখুন (সিস্টেমের উপর নির্ভর করে)।
2. প্রজেক্টের settings.yaml এ projectId এর মান প্রতিস্থাপন করুন।
3. ঐচ্ছিকভাবে, স্থানীয় কনফিগারেশন ফাইলগুলিকে অ্যাকশন প্রকল্পে অনুলিপি করতে gactions push চালান।

git clone https://github.com/my/repo.git
Cloning into 'repo'...
remote: Enumerating objects: 10, done.
remote: Counting objects: 100% (10/10), done.
remote: Compressing objects: 100% (9/9), done.
remote: Total 51 (delta 3), reused 3 (delta 1), pack-reused 41
Receiving objects: 100% (51/51), 36.86 KiB | 3.69 MiB/s, done.
Resolving deltas: 100% (11/11), done.
cd repo/sdk/
vi settings/settings.yaml
// change the value of `projectId`
gactions push

তালিকা সংস্করণ

আপনার অ্যাকশনের সংস্করণের বিবরণ দেখতে gactions versions list চালান। সংস্করণ স্ট্যাটাস সম্পর্কে আরও জানতে, রাজ্যের রেফারেন্স পড়ুন।

gactions versions list
Version         Status          Last Modified By        Modified On     
1           Created     [e-mail]  2020-09-28 20:22:04

যদি আপনার স্থাপনার স্থিতি বলে "সৃষ্টি ব্যর্থ হয়েছে", আপনি "রিলিজ" বিভাগের অধীনে কনসোলে এটি সম্পর্কে আরও বিশদ বিবরণ পেতে পারেন।

প্রকল্প স্থাপন

gactions deploy কমান্ড আপনাকে অ্যাকশন সিমুলেটরে পরীক্ষা করার জন্য বা আলফা/বিটা/প্রোডাকশন রিলিজ চ্যানেলে স্থাপন করার জন্য আপনার প্রকল্প স্থাপন করতে দেয়।

দ্রষ্টব্য: আপনি যদি আপনার অ্যাকশন প্রকল্পে ইনলাইন পূরণ ব্যবহার করেন, তাহলে gactions deploy কমান্ড চালানোর আগে আপনার একটি বিলিং প্রোফাইল সক্রিয় থাকতে হবে। আপনি যদি বিলিং সেট-আপ না করেন, তাহলে আপনি মোতায়েন করার সময় ত্রুটির সম্মুখীন হতে পারেন যা আপনি আবার স্থাপন করার আগে সমাধান করতে 5-10 মিনিট সময় নিতে পারে।

সিমুলেটরে পূর্বরূপ

আপনার অ্যাকশনকে "প্রিভিউ"-এ স্থাপন করতে gactions deploy preview চালান, যা আপনাকে আপনার অ্যাকশন প্রকল্পের সংস্করণ আপডেট না করে বা অন্য ডেভেলপারদের প্রভাবিত না করেই কনসোলে আপনার অ্যাকশন পরীক্ষা করতে দেয়। অন্য কথায়, আপনার স্থানীয় ফাইল সিস্টেমে আপনি যে পরিবর্তনগুলি করেন তার কোনোটিই আপনার অ্যাকশন প্রকল্পের স্থাপন করা সংস্করণগুলিতে প্রচারিত হয় না, তবে সেগুলি একটি পূর্বরূপ সংস্করণে পরীক্ষা করার জন্য উপলব্ধ।

দ্রষ্টব্য: এই প্রক্রিয়াটির অন্তত প্রধান আহ্বান ( custom/global/actions.intent.MAIN.yaml ) সংজ্ঞায়িত করা প্রয়োজন।

gactions deploy preview
Deploying your project files to your Actions console preview for a project id: "my-project". This may take a few minutes.
Sending configuration files
Waiting for server to respond.
✔ Done. You can now navigate to the Actions Console simulator to test your changes: http://console.actions.google.com/project/my-project/simulator?disableAutoPreview

রিলিজ তৈরি করুন

আলফা/বিটা/প্রোড চ্যানেলের সংস্করণ রিলিজ তৈরি করতে gactions deploy চালান যা আপনি অ্যাকশন কনসোলের ডিপ্লয় বিভাগের মাধ্যমে পরিচালনা করতে পারেন। আপনার আলফা এবং/অথবা বিটা চ্যানেলগুলির সাথে আপনার অ্যাকশনের রিলিজ প্রার্থীদের পরীক্ষা করতে এটি ব্যবহার করুন এবং আপনি প্রতিক্রিয়াতে সন্তুষ্ট হলে রিলিজ প্রার্থীকে উৎপাদনে নিয়ে যান।

gactions deploy alpha
Deploying your project files to a actions.channels.Alpha channel for a project id: "my-project-id"
Sending configuration files
Waiting for server to respond.
✔ Done. Your Action was deployed to actions.channels.Alpha channel. You can check status of deployment in the Actions Console.

রিলিজ চ্যানেলের তালিকা করা

আপনার অ্যাকশনের জন্য রিলিজ চ্যানেলের বিবরণ দেখতে gactions release-channels list চালান। আপনি প্রতিটি চ্যানেলে স্থাপন করা বা মুলতুবি থাকা সংস্করণ সনাক্ত করতে এই কমান্ডটি ব্যবহার করতে পারেন।

gactions release-channels list
Release Channel             Current Version             Pending Version
alpha                   1                     N/A

অ্যাকাউন্ট লিঙ্কিং

gactions encrypt এবং gactions decrypt কমান্ড আপনাকে OAuth2 ক্লায়েন্ট গোপনীয়তা পরিচালনা করতে দেয়। এই কমান্ডগুলি অ্যাকাউন্ট লিঙ্ক করার জন্য নির্দিষ্ট।

ক্লায়েন্ট গোপনীয়তা লিঙ্ক OAuth2 অ্যাকাউন্ট এনক্রিপ্ট করুন

auth কোড OAuth2 অ্যাকাউন্ট লিঙ্কিং ফ্লোগুলির জন্য ক্লায়েন্টের গোপনীয়তাগুলিকে নিরাপদে যুক্ত করতে বা একটি নতুন এনক্রিপশন কী দিয়ে বিদ্যমান গোপনীয়তাগুলিকে এনক্রিপ্ট করতে gactions encrypt চালান৷

gactions encrypt
Write your secret: *********************
Encrypting your client secret
path/to/myAction/sdk/settings/accountLinkingSecret.yaml already exists. Would you like to overwrite it?. [y/n]
y
✔ Done. Encrypted secret was written to path/to/myAction/sdk/settings/accountLinkingSecret.yaml

এনক্রিপ্ট করা অ্যাকাউন্ট লিঙ্কিং গোপনীয়তার প্লেইন টেক্সট মান অ্যাক্সেস করুন।

আপনি যদি সাময়িকভাবে প্রকল্পের গোপনীয়তার প্লেইন টেক্সট মান অ্যাক্সেস করতে চান তাহলে gactions decrypt চালান। কমান্ডটি আপনার পছন্দের একটি পাঠ্য ফাইলে মানটি প্রিন্ট করে। প্লেইন টেক্সট মানের কোনো দুর্ঘটনাজনিত ফাঁস এড়াতে আমরা গন্তব্য ফাইলটিকে প্রকল্পের রুট ফোল্ডারের বাইরে রাখার পরামর্শ দিই।

gactions decrypt ../../burn_after_read.txt
Decrypting your client secret
✔ Done. Check path/above/myActions/burn_after_read.txt to find decrypted client secret.
vi ../../burn_after_read.txt
rm ../../burn_after_read.txt