You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/www/docs/contribute/99-troubleshooting.md
+37-29Lines changed: 37 additions & 29 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,24 +9,22 @@ sidebar_position: 99
9
9
:::info
10
10
This page lists frequently-asked questions and solutions to help troubleshoot common issues that may be encountered when building or testing the project.
11
11
:::
12
+
12
13
## `swa deploy` fails with no logs
13
14
14
15
### Context
15
16
16
-
`swa deploy` currently has a small bug which is being actively worked on by the team. When a user tries to `swa deploy` from within the `app-location`, the deploy command currently fails with an unknown error. This is being tracked in GitHub issue #[514]((https://github.com/Azure/static-web-apps-cli/issues/514).
17
+
`swa deploy` currently has a small bug which is being actively worked on by the team. When a user tries to `swa deploy` from within the `app-location`, the deploy command currently fails with an unknown error. This is being tracked in GitHub issue #[514]((https://github.com/Azure/static-web-apps-cli/issues/514).
17
18
18
19
### Solution
19
20
20
21
While the team is currently working on the fix, we recommend users to use the other methods of deployment, all documented [here](https://azure.github.io/static-web-apps-cli/docs/cli/swa-deploy)). In case the project does not have an `app-location` folder (i.e. main project is in the `root` folder), we'd recommend using the [Azure Static Web Apps portal](https://portal.azure.com) or [VSCode](https://docs.microsoft.com/en-us/azure/static-web-apps/getting-started?tabs=vanilla-javascript) extension meanwhile!
21
22
22
-
23
-
24
-
25
23
## `libsecret-1.so.0: cannot open shared object file: No such file or directory`
26
24
27
25
### Context
28
26
29
-
When using `swa login`, the flag `--use-keychain` is enabled by default because we encrypt and store your credentials in your native Keychain (aka. the built-in password manager of your operating system). This operation depends on a system dependency called `libsecret`. If your system doesn't come bundled `libsecret` (most systems do provide it by default), you will then encounter this error.
27
+
When using `swa login`, the flag `--use-keychain` is enabled by default because we encrypt and store your credentials in your native Keychain (aka. the built-in password manager of your operating system). This operation depends on a system dependency called `libsecret`. If your system doesn't come bundled `libsecret` (most systems do provide it by default), you will then encounter this error.
30
28
31
29
### Why do I need to `swa login`?
32
30
@@ -35,20 +33,22 @@ In order to be able to automatically deploy your app to your Azure Static Web Ap
35
33
### Solutions
36
34
37
35
In order to avoid this issue, you have a few options:
36
+
38
37
1.[Manually install](https://www.google.com/search?q=instal+libsecret)`libsecret` by adding it to your Docker image or your system (recommended)
39
38
2. Disable Keychain access using `--no-use-keychain`. Doing so won't store and remember your credentials anymore, and you will have to interactively log in again each time you run `swa login`
40
39
3. Manually provide the Deployment Token for your current project (see [SWA CLI docs](https://azure.github.io/static-web-apps-cli/docs/use/deploy#51-deployment-token)). You will also need to provide `--app-name` and `--resource-group`
41
40
4. Manually provide `--client-id`, `--client-secret`, `--app-name` and `--resource-group`.
42
41
43
-
44
42
## SWA CLI - Domains that need Firewall access
45
43
46
44
### Context
45
+
47
46
If you are having trouble accessing SWA CLI, the following domains need to be allowed an access in your firewall:
47
+
48
48
- blob.core.windows.net
49
49
- azurestaticapps.net
50
50
- swalocaldeploy.azureedge.net
51
-
51
+
- functionscdn.azureedge.net
52
52
53
53
## `Unable to download StaticSitesClient binary (File Not Found 404 - 403)`
54
54
@@ -62,42 +62,47 @@ It can happen that the host firewall can block downloading these binaries. If us
1. Create a file at `$HOME/.swa/deploy/StaticSitesClient.json` with the following content:
95
+
93
96
```json
94
97
{
95
98
"metadata": PASTE STABLE JSON CONTENT,
96
99
"binary": ABSOLUTE PATH TO STATIC SITE CLIENT BINARY,
97
100
"checksum": SH256 CHECKSUM OF THE BINARY SEE BELOW
98
101
}
99
102
```
100
-
For eg:
103
+
104
+
For eg:
105
+
101
106
```json
102
107
{
103
108
"metadata": {
@@ -110,21 +115,24 @@ For eg:
110
115
}
111
116
```
112
117
113
-
**IMPORTANT: Make sure the `StaticSitesClient.json#checksum` and `StaticSitesClient.json#metadata.files.[OS].sha` values match!**
114
-
6. For Linux and macOS, run `chmod +x /home/USER/.swa/deploy/1.0.020761/StaticSitesClient`
115
-
7. Run `swa deploy --verbose silly` and make sure `SWA_CLI_DEPLOY_BINARY` is set correctly. If everything was configured correctly, the deploy should work.
116
-
118
+
**IMPORTANT: Make sure the `StaticSitesClient.json#checksum` and `StaticSitesClient.json#metadata.files.[OS].sha` values match!** 6. For Linux and macOS, run `chmod +x /home/USER/.swa/deploy/1.0.020761/StaticSitesClient` 7. Run `swa deploy --verbose silly` and make sure `SWA_CLI_DEPLOY_BINARY` is set correctly. If everything was configured correctly, the deploy should work.
0 commit comments