Szybki start: tworzenie usługi Azure Database for PostgreSQL — pojedynczy serwer za pomocą polecenia az postgres up
DOTYCZY: Azure Database for PostgreSQL — pojedynczy serwer
Ważne
Usługa Azure Database for PostgreSQL — pojedynczy serwer znajduje się na ścieżce wycofania. Zdecydowanie zalecamy uaktualnienie do usługi Azure Database for PostgreSQL — serwer elastyczny. Aby uzyskać więcej informacji na temat migracji do usługi Azure Database for PostgreSQL — serwer elastyczny, zobacz Co się dzieje z usługą Azure Database for PostgreSQL — pojedynczy serwer?.
Azure Database for PostgreSQL to usługa zarządzana, która umożliwia uruchamianie i skalowanie w chmurze baz danych PostgreSQL o wysokiej dostępności, a także zarządzanie nimi. Interfejs wiersza polecenia platformy Azure umożliwia tworzenie zasobów Azure i zarządzanie nimi z poziomu wiersza polecenia lub skryptów. W tym przewodniku Szybki start pokazano, jak utworzyć serwer usługi Azure Database for PostgreSQL przy użyciu interfejsu wiersza polecenia platformy Azure za pomocą polecenia az postgres up . Oprócz tworzenia serwera az postgres up
polecenie tworzy przykładową bazę danych, użytkownika głównego w bazie danych, otwiera zaporę dla usług platformy Azure i tworzy domyślne reguły zapory dla komputera klienckiego. Te wartości domyślne pomagają przyspieszyć proces programowania.
Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto platformy Azure.
Tworzenie serwera usługi Azure Database for PostgreSQL
Wymagania wstępne
Użyj środowiska powłoki Bash w usłudze Azure Cloud Shell. Aby uzyskać więcej informacji, zobacz Szybki start dotyczący powłoki Bash w usłudze Azure Cloud Shell.
Jeśli wolisz uruchamiać polecenia referencyjne interfejsu wiersza polecenia lokalnie, zainstaluj interfejs wiersza polecenia platformy Azure. Jeśli korzystasz z systemu Windows lub macOS, rozważ uruchomienie interfejsu wiersza polecenia platformy Azure w kontenerze Docker. Aby uzyskać więcej informacji, zobacz Jak uruchomić interfejs wiersza polecenia platformy Azure w kontenerze platformy Docker.
Jeśli korzystasz z instalacji lokalnej, zaloguj się do interfejsu wiersza polecenia platformy Azure za pomocą polecenia az login. Aby ukończyć proces uwierzytelniania, wykonaj kroki wyświetlane w terminalu. Aby uzyskać inne opcje logowania, zobacz Logowanie się przy użyciu interfejsu wiersza polecenia platformy Azure.
Po wyświetleniu monitu zainstaluj rozszerzenie interfejsu wiersza polecenia platformy Azure podczas pierwszego użycia. Aby uzyskać więcej informacji na temat rozszerzeń, zobacz Korzystanie z rozszerzeń w interfejsie wiersza polecenia platformy Azure.
Uruchom polecenie az version, aby znaleźć zainstalowane wersje i biblioteki zależne. Aby uaktualnić do najnowszej wersji, uruchom polecenie az upgrade.
Uruchamianie usługi Azure Cloud Shell
Usługa Azure Cloud Shell to bezpłatna interaktywna powłoka, której możesz używać do wykonywania kroków opisanych w tym artykule. Udostępnia ona wstępnie zainstalowane i najczęściej używane narzędzia platformy Azure, które są skonfigurowane do użycia na koncie.
Aby otworzyć usługę Cloud Shell, wybierz pozycję Wypróbuj w prawym górnym rogu bloku kodu. Możesz również uruchomić usługę Cloud Shell w oddzielnej karcie przeglądarki, przechodząc do strony https://shell.azure.com.
Po otwarciu usługi Cloud Shell sprawdź, czy dla danego środowiska wybrano powłokę Bash . Kolejne sesje będą używać interfejsu wiersza polecenia platformy Azure w środowisku powłoki Bash, wybierz pozycję Kopiuj , aby skopiować bloki kodu, wkleić go do usługi Cloud Shell i nacisnąć Enter , aby go uruchomić.
Logowanie się do platformy Azure
Usługa Cloud Shell jest automatycznie uwierzytelniana na początkowym koncie zalogowanym. Użyj następującego skryptu, aby zalogować się przy użyciu innej subskrypcji, zastępując <Subscription ID>
element identyfikatorem subskrypcji platformy Azure. Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto platformy Azure.
subscription="<subscriptionId>" # add subscription here
az account set -s $subscription # ...or use 'az login'
Aby uzyskać więcej informacji, zobacz set active subscription or log in interactively (Ustawianie aktywnej subskrypcji lub logowanie się interaktywnie)
Zainstaluj rozszerzenie db-up. Jeśli zostanie zwrócony błąd, upewnij się, że zainstalowano najnowszą wersję interfejsu wiersza polecenia platformy Azure. Zobacz Instalowanie interfejsu wiersza polecenia platformy Azure.
az extension add --name db-up
Utwórz serwer usługi Azure Database for PostgreSQL przy użyciu następującego polecenia:
az postgres up
Serwer jest tworzony z następującymi wartościami domyślnymi (chyba że zostaną one ręcznie zastąpione):
Ustawienie | Wartość domyślna | Opis |
---|---|---|
nazwa-serwera | Wygenerowany przez system | Unikatowa nazwę, która identyfikuje serwer usługi Azure Database for PostgreSQL. |
resource-group | Wygenerowany przez system | Nowa grupa zasobów platformy Azure. |
sku-name | GP_Gen5_2 | Nazwa jednostki SKU. Jest zgodna z konwencją {warstwa cenowa}_{generacja obliczeniowa}_{rdzenie wirtualne} w skrócie. Wartość domyślna to serwer Ogólnego przeznaczenia Gen5 z 2 rdzeniami wirtualnymi. Aby uzyskać więcej informacji na temat warstw, zobacz naszą stronę cennika. |
backup-retention | 7 | Jak długo jest przechowywana kopia zapasowa. Jednostka to dni. |
geo-redundant-backup | Disabled | Określa, czy dla tego serwera powinny być włączone kopie zapasowe geograficznie nadmiarowe. |
lokalizacja | westus2 | Lokalizacja platformy Azure dla serwera. |
ssl-enforcement | Disabled | Określa, czy protokół TLS/SSL powinien być włączony, czy nie dla tego serwera. |
storage-size | 5120 | Pojemność magazynu serwera (w megabajtach). |
version | 10 | Wersja główna PostgreSQL. |
admin-user | Wygenerowany przez system | Nazwa użytkownika administratora. |
admin-password | Wygenerowany przez system | Hasło użytkownika administratora. |
Uwaga
Aby uzyskać więcej informacji na temat az postgres up
polecenia i jego dodatkowych parametrów, zobacz dokumentację interfejsu wiersza polecenia platformy Azure.
Po utworzeniu serwera są dostarczane następujące ustawienia:
- Zostanie utworzona reguła zapory o nazwie "devbox". Interfejs wiersza polecenia platformy Azure próbuje wykryć adres IP maszyny,
az postgres up
z której jest uruchamiane polecenie i zezwala na ten adres IP. - Ustawienie "Zezwalaj na dostęp do usług platformy Azure" ma wartość WŁĄCZONE. To ustawienie umożliwia skonfigurowanie zapory serwera tak, aby akceptowała połączenia ze wszystkich zasobów platformy Azure, w tym zasobów, które nie są używane w ramach subskrypcji.
- Zostanie utworzona pusta baza danych o nazwie "sampledb"
- Zostanie utworzony nowy użytkownik o nazwie "root" z uprawnieniami do "sampledb"
Uwaga
Usługa Azure Database for PostgreSQL komunikuje się za pośrednictwem portu 5432. Podczas nawiązywania połączenia z sieci firmowej ruch wychodzący przez port 5432 może być blokowany przez zaporę sieciową. Aby nawiązać połączenie z serwerem, dział IT otwórz port 5432.
Uzyskiwanie informacji o połączeniu
Po zakończeniu az postgres up
polecenia zostanie zwrócona lista parametry połączenia dla popularnych języków programowania. Te parametry połączenia są wstępnie skonfigurowane przy użyciu określonych atrybutów nowo utworzonego serwera usługi Azure Database for PostgreSQL.
Możesz użyć polecenia az postgres show-connection-string, aby ponownie wyświetlić te parametry połączenia.
Czyszczenie zasobów
Wyczyść wszystkie zasoby utworzone w przewodniku Szybki start przy użyciu następującego polecenia. To polecenie usuwa serwer usługi Azure Database for PostgreSQL i grupę zasobów.
az postgres down --delete-group
Jeśli chcesz usunąć nowo utworzony serwer, możesz uruchomić polecenie az postgres down .
az postgres down