przewodnik użytkownika po tagach

Z tego przewodnika dowiesz się, jak korzystać z narzędzia interfejsu wiersza poleceń gactions w typowych scenariuszach użytkowania. Informacje o kompleksowym tworzeniu akcji znajdziesz w znajdziesz w dokumentacji dotyczącej tworzenia akcji dotyczących rozmów Build.

Synchronizacja projektu

Jeśli korzystasz z pakietu Actions SDK, do synchronizowania projektów Action służą gactions między konsolą Actions a lokalnym systemem plików.

Operacje gactions pull eksportują projekt z konsoli Actions do oraz operacje gactions push przesyłają projekt z lokalnego systemu plików do konsoli Actions.

Pobierz działania z Konsoli Actions

Uruchom gactions pull, aby skopiować konfigurację projektu Actions do środowiska lokalnego systemu plików.

Pole project-id projektu, które chcesz skopiować, można przekazać w poleceniu lub w pliku settings/settings.yaml. Jeśli obecne są oba, Interfejs wiersza poleceń daje pierwszeństwo wartości przekazywanej jako opcja.

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

Fragment kodu powyżej pokazuje, jak pobrać działanie z wersji roboczej projektu. Jest a także pobrać z konkretnej wersji akcji. Wersja reprezentuje przesłaną kopię projektu w Actions, który można wdrożyć kanał wersji.

Flaga --version-id określa, którą wersję pobrać.

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

Użyj flagi --force, jeśli chcesz zastąpić lokalne kopie pliku bez danych pojawia się prośba o potwierdzenie. Użyj flagi --clean, by usunąć wszystkie wartości lokalne plików, których nie ma w zdalnej wersji roboczej ani wersji. Połącz je, aby uzyskać dokładna kopia projektu w Konsoli Actions.

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

Przenieś działania do wersji roboczej projektu w Konsoli Actions

Uruchom gactions push, aby przekazać zmiany z lokalnego systemu plików do wersji roboczej akcję w konsoli. Jest to przydatne w fazie programowania, widoczne w Konsoli Actions zmiany bez wpływu na wersji używanej do testowania.

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"

Zaimportuj istniejący projekt z systemu zarządzania kodem źródłowym

Jeśli chcesz pracować nad istniejącym projektem z poziomu wersji w kontroli wersji system:

  1. Sprawdź wersję docelową (zależy od systemu).
  2. Zastąp wartość projectId w elemencie settings.yaml projektu.
  3. Opcjonalnie uruchom gactions push, aby skopiować lokalne pliki konfiguracji do Projekt Actions.
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

Wersje strony aplikacji

Uruchom gactions versions list, aby wyświetlić szczegółowe informacje o wersjach akcji. Więcej informacji o stanach wersji znajdziesz w artykule Stan.

gactions versions list
Version         Status          Last Modified By        Modified On     
1           Created     your-email@your-domain.com  2020-09-28 20:22:04

Jeśli stan wdrożenia to „Nie udało się utworzyć”, możesz uzyskać więcej informacji możesz dowiedzieć się o nim więcej w sekcji „Wersja” w Konsoli Play. .

Wdrażanie projektów

Polecenie gactions deploy pozwala wdrożyć projekt do testowania w Symulator Actions albo wdróż go w kanałach wersji alfa, beta lub produkcyjnej.

Podgląd w symulatorze

Uruchom gactions deploy preview, aby wdrożyć działanie w trybie „podglądu”, co pozwala Testujesz akcję w konsoli, nie aktualizując jej wersji, w projekcie akcji ani na innych deweloperów. Innymi słowy, żaden zmiany wprowadzone w lokalnym systemie plików są przekazywane do wdrożonych wersji projektu w Actions, ale można je przetestować w wersji testowej.

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

Tworzenie wersji

Uruchom gactions deploy, aby utworzyć wersje dla kanałów alfa, beta i produkcyjnych którymi możesz zarządzać w sekcji Wdrażanie w Konsoli Actions. Służy do testowania kandydatów do wersji akcji przy użyciu wersji alfa lub beta. kanały, a jeśli wszystko jest satysfakcjonujące, przenieś kandydatu do wersji produkcyjnej z opiniami.

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.

Lista kanałów wersji

Uruchom gactions release-channels list, aby wyświetlić szczegóły kanałów wersji dla danej akcji. Za pomocą tego polecenia możesz określić wersję wdrożonych lub oczekujących na każdym kanale.

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

Łączenie kont

Polecenia gactions encrypt i gactions decrypt umożliwiają administrowanie protokołem OAuth2 tajne klucze klienta. Te polecenia dotyczą łączenia kont.

Szyfruj tajne klucze klienta połączenia konta OAuth2

Uruchom gactions encrypt, aby bezpiecznie dodać obiekty tajne klienta do konta OAuth2 z kodem autoryzacji między przepływami danych i w celu szyfrowania istniejących obiektów tajnych za pomocą nowego klucza szyfrowania.

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

Dostęp do wartości w postaci zwykłego tekstu do zaszyfrowanych obiektów tajnych połączenia kont.

Uruchom gactions decrypt, jeśli chcesz tymczasowo uzyskać dostęp do wartości zwykłego tekstu do obiektu tajnego projektu. To polecenie wydrukuje wartość do wybranego pliku tekstowego. Zalecamy, aby plik docelowy był poza folderem głównym projektu, w celu uniknięcia przypadkowego wycieku wartości zwykłego tekstu.

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