Close

Łączenie flagi funkcji ze zgłoszeniami w Split i Jira

Kevin Li — zdjęcie portretowe
Kevin Li

Menedżer produktu, Split

W samouczku opisano szczegółowo sposób łączenia zgłoszenia z flagą funkcji oraz wyświetlania powiązanych z tym informacji zarówno w systemie Jira, jak i w rozwiązaniu Split.

Godzina

10 minut

Publiczność

Użytkownicy Jira Software i Split.

Wymagania wstępne

Split jest ujednoliconą platformą dostarczania funkcji, która łączy szybkość i niezawodność flag funkcji z danymi, umożliwiając zespołom tworzącym oprogramowanie zmierzenie wpływu zmian w kodzie oraz dostarczanie funkcji sprzyjających zwiększaniu wyników biznesowych.

Krok 1: Łączenie flagi funkcji ze zgłoszeniem

Po utworzeniu zgłoszenia w obszarze szczegółów zgłoszenia z prawej strony ekranu będzie widoczne pole Wydania. Kliknij przycisk + Dodaj flagę funkcji i wybierz opcję Utwórz flagę funkcji lub Połącz flagę funkcji.

Flaga funkcji to narzędzie programistyczne przeznaczone do bezpiecznego aktywowania lub dezaktywowania funkcji na potrzeby testów w środowisku produkcyjnym, stopniowego wydawania, eksperymentowania i eksploatacji.

Wybranie opcji Połącz flagę funkcji spowoduje przekierowanie do formularza w rozwiązaniu Split, gdzie można wskazać przestrzeń roboczą (wybraną w trakcie konfiguracji Jira Cloud w rozwiązaniu Split) oraz flagę funkcji (split), która ma być połączona z danym zgłoszeniem Jira. Można zauważyć, że numer zgłoszenia Jira został wstępnie wypełniony w rozwiązaniu Split, aby zaoszczędzić czas potrzebny na kopiowanie i wklejanie z jednego narzędzia do drugiego.

Połącz flagę funkcjonalności

W przypadku wybrania opcji Utwórz flagę funkcji nastąpi przekierowanie do formularza tworzenia flagi funkcji (splitu) w rozwiązaniu Split. W tym miejscu wystarczy wskazać przestrzeń roboczą (wybraną w trakcie konfiguracji Jira Cloud w rozwiązaniu Split), nadać splitowi nazwę, wybrać typ ruchu (typ kluczy używanych do oceny flagi) oraz wskazać co najmniej jednego właściciela (użytkownika z uprawnieniami do edycji tego splitu). Warto również uzupełnić pola Tags (Tagi) oraz Description (Opis), aby ułatwić sobie oraz innym członkom zespołu porządkowanie i identyfikowanie splitów w miarę skalowania.

Ponownie numer zgłoszenia Jira został wstępnie wypełniony dla wygody. W razie potrzeby w polu zgłoszenia Jira można również dodać wiele zgłoszeń Jira.

Połącz flagę funkcjonalności

Gdy flaga funkcji zostanie pomyślnie dodana do zgłoszenia Jira, w polu Wydania będzie widać nazwę oraz status flagi funkcji. Jeśli flaga ma już skonfigurowane reguły targetowania, status odzwierciedlony w polu Wydania będzie miał wartość „WŁ.” (niezależnie od tego, czy flaga będzie aktywnie targetowała użytkowników, czy nie). Jeśli do flagi nie dodano żadnych reguł targetowania, jej status to „WYŁ.”.

Opcjonalnie, w razie potrzeby, można kliknąć ikonę „+” obok pola Wydania, aby dodać wiele flag funkcji. W przypadku wielu połączonych flag wyświetlana będzie liczba flag ze statusem „WŁ.”. Jeśli dla żadnej flagi nie zostanie skonfigurowana reguła targetowania, widoczna będzie liczba flag ze statusem „WYŁ.”. Po umieszczeniu kursora na polu Wydania zostaną wyświetlone nazwy flag.

Krok 2: Ustawianie reguł targetowania dla flagi funkcji

Rozwiązanie Split oferuje wiele sposobów kierowania do użytkowników przy użyciu flag funkcji w ramach wdrażania kontrolowanego.

Wdrażanie kontrolowane polega na wprowadzaniu funkcji z wykorzystaniem bardzo szczegółowego targetowania użytkowników. Pozwala to na stopniowe wydawanie nowych funkcji, upewniając się, że mniejsza grupa użytkowników będzie miała dobre doświadczenia przed udostępnieniem ich większej grupie.

Dla każdego wariantu można wskazać konkretnych użytkowników w oparciu o wstępnie zdefiniowane listy: (segmenty), reguły targetowania i procentowy udział w ruchu. Reguły targetowania mogą opierać się na dowolnym atrybucie użytkownika dostępnym dla pakietu SDK rozwiązania Split uruchomionego w danej aplikacji, takim jak lokalizacja, wiek, wielkość koszyka itp. Po zebraniu razem te metody targetowania umożliwiają precyzyjną kontrolę nad segmentacją użytkowników na potrzeby wdrożeń i eksperymentów.

Na początek zostanie przedstawiony proces wdrażania kontrolowanego, w którym funkcję najpierw udostępnia się określonemu odsetkowi użytkowników. Można w ten sposób przetestować nową funkcję na niewielkim odsetku użytkowników i sprawdzić ich reakcje (oraz sposób działania aplikacji). Jeśli reakcje będą pozytywne, można zwiększać ten odsetek do momentu, gdy 100% użytkowników będzie już korzystało z nowej funkcji.

Do wdrażania kontrolowanego według odsetka użytkowników służy funkcja Default Rule (Reguła domyślna) w rozwiązaniu Split. Ta reguła jest stosowana w przypadku braku jakichkolwiek innych reguł targetowania lub w odniesieniu do użytkowników, którzy nie spełniają kryteriów zdefiniowanych we wszelkich innych regułach targetowania.

Kliknij flagę funkcji w polu Wydania w systemie Jira. Nastąpi przekierowanie na kartę Targeting rules (Reguły targetowania) flagi w rozwiązaniu Split. Przed utworzeniem jakichkolwiek reguł targetowania trzeba w pierwszej kolejności zdefiniować warianty w obszarze Define Treatments (Zdefiniuj warianty). Warianty flagi to różne odmiany funkcji, które chcesz zastosować u użytkowników. Ich najprostszą postacią są warianty „On” (pokaż funkcję) lub „Off” (nie pokazuj funkcji).

Definiowanie wariantów

Po zdefiniowaniu wariantów przewiń w dół do reguły Set the default (Ustaw domyślną) i opcję Percentage (Odsetek) z listy rozwijanej serve (dostarczanie). W tym miejscu możesz przypisać odsetek użytkowników przydzielanych losowo do każdego wariantu. Wartości procentowe zależą od tolerancji ryzyka. Przykładowo, jeśli jest to funkcja wysokiego ryzyka, możesz ustawić 1% przy „On” i 99% przy „Off”. Po przydzieleniu wartości procentowych do poszczególnych wariantów kliknij przycisk Save changes (Zapisz zmiany) w prawym górnym rogu karty, aby zastosować regułę.

Ustaw wartości domyślne

Teraz po wyświetleniu tej flagi funkcji obok pola Wydania w systemie Jira zobaczysz zaktualizowany status „WŁ.” oznaczający, że flaga została skonfigurowana z zastosowaniem reguł targetowania. Po umieszczeniu kursora na fladze pojawi się nazwa wariantu i odsetek użytkowników przypisanych losowo do danego wariantu. W tym przykładzie po umieszczeniu kursora będzie widoczna informacja „1% on” (1% wł.). W przypadku zmodyfikowania reguł targetowania w rozwiązaniu Split wartość wyświetlana po umieszczeniu kursora zostanie automatycznie zaktualizowana.

Przykładowo, jeśli zdecydujesz się dodać regułę, aby testerzy QA zawsze otrzymywali wariant „On”, a nie byli przydzielani losowo do 1% użytkowników z wariantem „On” lub 99% użytkowników z wariantem „Off” na podstawie reguły domyślnej, możesz z łatwością skonfigurować właściwe ustawienie w rozwiązaniu Split poprzez utworzenie segmentu zawierającego testerów QA.

Po utworzeniu segmentu w rozwiązaniu Split wróć na kartę Targeting rules (Reguły targetowania) i kliknij opcję Create Whitelists (Utwórz listy dozwolonych), aby dodać segment testerów QA, dzięki czemu zawsze będą oni otrzymywali wariant „On”.

Tworzenie list dozwolonych

Jeśli teraz spojrzysz na tę flagę funkcji obok pola Wydania w systemie Jira, po umieszczeniu kursora na fladze zobaczysz liczbę obowiązujących reguł targetowania. W tym przykładzie po umieszczeniu kursora pojawi się informacja „2 rules” (2 reguły).

Krok 3: Udostępnienie flagi funkcji większej liczbie użytkowników

Gdy zyskasz pewność, że funkcję można udostępnić większej liczbie użytkowników, możesz zaktualizować pozycję Default Rule (Reguła domyślna) i zwiększyć odsetek użytkowników przypisywanych losowo do wariantu „On”.

Najlepiej jeśli wcześniej upewnisz się, że nie ma żadnych niezamkniętych zgłoszeń Jira powiązanych z daną flagą funkcji. Można to szybko sprawdzić w rozwiązaniu Split, przechodząc na kartę Additional settings (Dodatkowe ustawienia) i przeglądając obszar External objects (Obiekty zewnętrzne) danej flagi (splitu). W tym przypadku widać, że zgłoszenie połączone w kroku 1 ma status Gotowe i nie ma żadnych innych zaległych zgłoszeń. Można zatem bezpiecznie zwiększyć zasięg splitu!

Wyświetlanie zgłoszenia Jira

Jeśli zauważysz zgłoszenie, którego status będzie inny niż Gotowe, możesz je kliknąć, aby wyświetlić jego szczegóły w systemie Jira, lub skontaktować się bezpośrednio z osobą przypisaną, aby uzyskać aktualne informacje. W tym miejscu możesz również dodać więcej zgłoszeń Jira.

Aby udostępnić split większej liczbie użytkowników, wróć na kartę Targeting rules (Reguły targetowania) danego splitu i zaktualizuj wartości procentowe w obszarze Default Rule (Reguła domyślna), ustalając przydziały według własnego uznania. Ten krok można powtarzać, dopóki funkcja nie zostanie wdrożona u 100% użytkowników.

Zobacz więcej integracji dla Atlassian Open DevOps.

Kevin Li
Kevin Li

Kevin Li is a product manager at Split who focuses on core feature flagging, security, and workflow-based features. Prior to his current home in product management, he spent time in sales engineering and customer success. Outside of work, he finds joy in doing anything out in the sun, whether it be backpacking, cooking, or reading.


Udostępnij ten artykuł
Następny temat

Zalecane lektury

Dodaj te zasoby do zakładek, aby dowiedzieć się więcej na temat rodzajów zespołów DevOps lub otrzymywać aktualności na temat metodyki DevOps w Atlassian.

Ilustracja DevOps

Społeczność DevOps

Ilustracja DevOps

Warsztaty symulacyjne

Ilustracja przedstawiająca mapę

Zacznij korzystać za darmo

Zapisz się do newslettera DevOps

Thank you for signing up