-
Notifications
You must be signed in to change notification settings - Fork 132
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
clean up after moving documentation to wiki
- Loading branch information
Showing
16 changed files
with
3 additions
and
87 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,84 +1,3 @@ | ||
# Deployment | ||
|
||
## First thing first | ||
|
||
### 👉 **Copy this repository** into your own account | ||
|
||
> To Copy a GitHub repository click on the use this template button on the top right of the screen. | ||
![Click on the button Use this template][CreateACopy] | ||
|
||
Provide a name. It can be anything, it just need to be unique in your account (you can keep TinyBlazorAdmin if you want). Add a description it you want, and click the button **Create repository from template**. | ||
|
||
![Give it a name description and click Create][NameYourCopy] | ||
|
||
After a few seconds, you should now be in your version of the TinyBlazorAdmin project. If you need more detail have a look to this GitHub doc: [Fork a repo](https://docs.github.com/en/free-pro-team@latest/github/getting-started-with-github/fork-a-repo). | ||
|
||
> Make sure you are currently in YOUR GitHub repository. | ||
> | ||
>![This should be YOUR repo][NotFBoucherRepo] | ||
|
||
## Deploy AzUrlShortener (the Backend) | ||
|
||
This project is a frontend for [Azure Url Shortener](https://github.com/FBoucher/AzUrlShortener). If it's not already done you will need to deploy this project in your Azure subscription. | ||
|
||
## Deploy TinyBlazorAdmin | ||
|
||
There are many ways you could run Tiny Blazor Admin website. In this deployment, we will use the new [Azure Static Web App (SWA)](https://azure.microsoft.com/en-ca/services/app-service/static/?WT.mc_id=tinyblazoradmin-github-frbouche). | ||
|
||
Open Azure portal (portal.azure.com), open the **resource group** where you created the backend (ex: streamDemo is our case). Click the "**+**" and search **Static Web App**, and click the *Create* button. | ||
|
||
![Creating swa][swa_create1] | ||
|
||
> Note: You will need to **Authorize Azure Static Web Apps**, to have access to _your_ GitHub repository (the one created when you forked the project). This is required because SWA uses GitHub Action to deploy. | ||
![Creating swa part 2][swa_create2] | ||
|
||
Select your organization, repository and branch (ex: main). | ||
|
||
![Creating swa part 3][swa_create3] | ||
|
||
Select **Blazor** as your *Build Presets*. The *App location* needs to be the location of the project file; in our case `src/admin`. The Api is in the `src/api`. The *App artifact location* can be left to wwwroot. | ||
|
||
Once it's all filled, click the Review, and create button. It will takes a few minutes to get deployed. During this time let's create and configure our security components. | ||
|
||
## Create Invite to add users to the Admin role | ||
|
||
Users need to be part of the of the role **admin** (all lowercase). To add them you need to use the *Role management* interface from in the Azure portal. | ||
|
||
From the [portal](https://portal.azure.com/), open your static web app and select the *Role management* from the left options list. From there click the Invive button make sure you type **admin** all lowercase without extra spaces in the Role field. | ||
|
||
![Create invire][create_invire] | ||
|
||
This will create an invite that you can share with the recipient. Once the invite is accepted, the name should be visible in the list. | ||
|
||
## Configuration | ||
|
||
Let's add the connection to the Azure Storage table. In your AzUrlShortener resource group us look for the Azure storage starting by "urldata" and grab the connectionstring. | ||
|
||
![get connectionstring][grab_connstring] | ||
|
||
Now that we have the connectionstring, add it the application setting of the Azure static web App under the name `UlsDataStorage`. | ||
|
||
![add UlsDataStorage application setting][add_config] | ||
|
||
The TinyBlazorAdmin doesn't need to have a custom domain name. It's just a website that will be used internally. So we can use the default URL provided by Azure Static Web App. However, to let it know what is the domain add another application setting named `customDomain`. This will be used in the copy button to quickly copy the short URL to the clipboard. | ||
|
||
![add customDomain application setting][add_custom_domain] | ||
|
||
## Try it! | ||
|
||
Voila, the deployment is now completed. You can test it by creating a new short URL using the admin SWA. | ||
|
||
[swa_create1]: medias/swa_create1.png | ||
[swa_create2]: medias/swa_create2.png | ||
[swa_create3]: medias/swa_create3.png | ||
[swa_URL]: medias/swa_URL.png | ||
[create_invire]: medias/create_invite.png | ||
[add_config]: medias/add_config.png | ||
[grab_connstring]: medias/grab_connstring.png | ||
[NotFBoucherRepo]: medias/NotFBoucherRepo.png | ||
[CreateACopy]: medias/CreateACopy.png | ||
[NameYourCopy]: medias/NameYourCopy.png | ||
[add_custom_domain]: medias/add_custom_domain.png | ||
⚠️ [Documentation moved to the WIKI](https://github.com/FBoucher/TinyBlazorAdmin/wiki/Deployment) 👈 |
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.