133 bug bash script fixes

.gitignore

@@ -28,6 +28,7 @@ website/node_modules
 import.tf
 generated.tf
 import/import_script
+terraform-provider-astro-import-script*
 
 website/vendor
 test_results

README.md

@@ -227,7 +227,6 @@ On Windows:
 
 - `-resources`: Comma-separated list of resources to import. Accepted values are workspace, deployment, cluster, api_token, team, team_roles, user_roles.
 - `-token`: API token to authenticate with the Astro platform. If not provided, the script will attempt to use the `ASTRO_API_TOKEN` environment variable.
-- `-host`: API host to connect to. Default is https://api.astronomer.io. Use "dev" for https://api.astronomer-dev.io or "stage" for https://api.astronomer-stage.io.
 - `-organizationId`: Organization ID to import resources from.
 - `-runTerraformInit`: Run `terraform init` after generating the import configuration. Used for initializing the Terraform state in our GitHub Actions.
 - `-help`: Display help information.
@@ -246,7 +245,7 @@ On Windows:
 
 3. Use a different API host (e.g., dev environment):
    ```
-   ./terraform-provider-astro-import-script_<version-number>_<os>_<arc> -resources workspace -token your_api_token -organizationId your_org_id -host dev
+   ./terraform-provider-astro-import-script_<version-number>_<os>_<arc> -resources workspace -token your_api_token -organizationId your_org_id
    ```
 
 ### Output
@@ -262,3 +261,43 @@ The script will generate two main files:
 - The generated Terraform configurations may require some manual adjustment to match your specific requirements or to resolve any conflicts.
 - Always review the generated files before applying them to your Terraform state.
 
+## FAQ and Troubleshooting
+
+### Frequently Asked Questions
+
+1. **What resources can I manage with this Terraform provider?** 
+   - Workspaces, deployments, clusters, hybrid cluster workspace authorizations, API tokens, teams, team roles, and user roles.
+
+2. **How do I authenticate with the Astro API?**
+   - Use an API token set as the `ASTRO_API_TOKEN` environment variable or provided in the provider configuration.
+
+3. **Can I import existing Astro resources into Terraform?**
+   - Yes, use the Astro Terraform Import Script to generate import blocks and resource configurations.
+
+4. **What Terraform and Go versions are required?**
+   - Terraform >= 1.7 and Go >= 1.21.
+
+5. **How can I contribute to the provider's development?**
+   - Submit pull requests, report issues, or suggest improvements on the GitHub repository.
+
+### Troubleshooting
+
+1. **Issue: 401 Unauthorized error when running `terraform plan` or `terraform apply`**
+
+   Solution: Your API token may have expired. Update your `ASTRO_API_TOKEN` environment variable with a fresh token:
+   ```
+   export ASTRO_API_TOKEN=<your-new-token>
+   ```
+
+2. **Issue: Import script fails to find resources**
+
+   Solution:
+    - Ensure you have the correct permissions in your Astro organization.
+    - Verify that your API token is valid and has the necessary scopes.
+    - Double-check the organization ID provided to the script.
+
+3. **Issue: "Error: Invalid provider configuration" when initializing Terraform**
+
+   Solution: Ensure your `.terraformrc` file is correctly set up, especially if you're using a local build of the provider for development.
+
+If you encounter any issues not listed here, please check the [GitHub Issues](https://github.com/astronomer/terraform-provider-astro/issues) page or open a new issue with details about your problem.

docs/data-sources/api_token.md

@@ -16,6 +16,11 @@ API Token data source
 data "astro_api_token" "example" {
   id = "clxm4836f00ql01me3nigmcr6"
 }
+
+# Output the API token value using terraform apply
+output "api_token" {
+  value = data.astro_api_token.example
+}
 ```
 
 <!-- schema generated by tfplugindocs -->

docs/data-sources/api_tokens.md

@@ -26,6 +26,11 @@ data "astro_api_tokens" "workspace_example" {
 data "astro_api_tokens" "deployment_example" {
   deployment_id = "clx44jyu001m201m5dzsbexqr"
 }
+
+# Output the API tokens value using terraform apply
+output "api_tokens" {
+  value = data.astro_api_tokens.example
+}
 ```
 
 <!-- schema generated by tfplugindocs -->

docs/data-sources/cluster.md

@@ -16,6 +16,11 @@ Cluster data source
 data "astro_cluster" "example" {
   id = "clozc036j01to01jrlgvueo8t"
 }
+
+# Output the cluster value using terraform apply
+output "cluster" {
+  value = data.astro_cluster.example
+}
 ```
 
 <!-- schema generated by tfplugindocs -->

docs/data-sources/cluster_options.md

@@ -21,6 +21,11 @@ data "astro_cluster_options" "example_cluster_options_filter_by_provider" {
   type           = "HYBRID"
   cloud_provider = "AWS"
 }
+
+# Output the cluster options value using terraform apply
+output "cluster_options" {
+  value = data.astro_cluster_options.example_cluster_options
+}
 ```
 
 <!-- schema generated by tfplugindocs -->

docs/data-sources/clusters.md

@@ -22,6 +22,11 @@ data "astro_clusters" "example_clusters_filter_by_names" {
 data "astro_clusters" "example_clusters_filter_by_cloud_provider" {
   cloud_provider = "AWS"
 }
+
+# Output the clusters value using terraform apply
+output "clusters" {
+  value = data.astro_clusters.example_clusters
+}
 ```
 
 <!-- schema generated by tfplugindocs -->

docs/data-sources/deployment.md

@@ -16,6 +16,11 @@ Deployment data source
 data "astro_deployment" "example" {
   id = "clozc036j01to01jrlgvueo8t"
 }
+
+# Output the deployment value using terraform apply
+output "deployment" {
+  value = data.astro_deployment.example
+}
 ```
 
 <!-- schema generated by tfplugindocs -->

docs/data-sources/deployment_options.md

@@ -30,6 +30,11 @@ data "astro_deployment_options" "example_with_executor_query_param" {
 data "astro_deployment_options" "example_with_cloud_provider_query_param" {
   cloud_provider = "AWS"
 }
+
+# Output the deployment options value using terraform apply
+output "deployment_options" {
+  value = data.astro_deployment_options.example
+}
 ```
 
 <!-- schema generated by tfplugindocs -->

docs/data-sources/deployments.md

@@ -26,6 +26,11 @@ data "astro_deployments" "example_deployments_filter_by_deployment_ids" {
 data "astro_deployments" "example_deployments_filter_by_workspace_ids" {
   workspace_ids = ["clozc036j01to01jrlgvu798d"]
 }
+
+# Output the deployments value using terraform apply
+output "deployments" {
+  value = data.astro_deployments.example_deployments
+}
 ```
 
 <!-- schema generated by tfplugindocs -->

docs/data-sources/organization.md

@@ -14,6 +14,11 @@ Organization data source
 
 ```terraform
 data "astro_organization" "example" {}
+
+# Output the organization value using terraform apply
+output "organization" {
+  value = data.astro_organization.example
+}
 ```
 
 <!-- schema generated by tfplugindocs -->

docs/data-sources/team.md

@@ -16,6 +16,11 @@ Team data source
 data "astro_team" "example" {
   id = "clwbclrc100bl01ozjj5s4jmq"
 }
+
+# Output the team value using terraform apply
+output "team" {
+  value = data.astro_team.example
+}
 ```
 
 <!-- schema generated by tfplugindocs -->

docs/data-sources/teams.md

@@ -18,6 +18,11 @@ data "astro_teams" "example_teams" {}
 data "astro_teams" "example_teams_filter_by_names" {
   names = ["my first team", "my second team"]
 }
+
+# Output the teams value using terraform apply
+output "example_teams" {
+  value = data.astro_teams.example_teams
+}
 ```
 
 <!-- schema generated by tfplugindocs -->

docs/data-sources/user.md

@@ -16,6 +16,11 @@ User data source
 data "astro_user" "example" {
   id = "clhpichn8002m01mqa4ocs7g6"
 }
+
+# Output the user value using terraform apply
+output "user" {
+  value = data.astro_user.example
+}
 ```
 
 <!-- schema generated by tfplugindocs -->

docs/data-sources/users.md

@@ -22,6 +22,11 @@ data "astro_users" "example_users_filter_by_workspace_id" {
 data "astro_users" "example_users_filter_by_deployment_id" {
   deployment_id = "clx44jyu001m201m5dzsbexqr"
 }
+
+# Output the users value using terraform apply
+output "example_users" {
+  value = data.astro_users.example_users
+}
 ```
 
 <!-- schema generated by tfplugindocs -->

docs/data-sources/workspace.md

@@ -16,6 +16,11 @@ Workspace data source
 data "astro_workspace" "example" {
   id = "clozc036j01to01jrlgvueo8t"
 }
+
+# Output the workspace value using terraform apply
+output "workspace" {
+  value = data.astro_workspace.example
+}
 ```
 
 <!-- schema generated by tfplugindocs -->

docs/data-sources/workspaces.md

@@ -22,6 +22,11 @@ data "astro_workspaces" "example_workspaces_filter_by_workspace_ids" {
 data "astro_workspaces" "example_workspaces_filter_by_names" {
   names = ["my first workspace", "my second workspace"]
 }
+
+# Output the workspaces value using terraform apply
+output "example_workspaces" {
+  value = data.astro_workspaces.example_workspaces
+}
 ```
 
 <!-- schema generated by tfplugindocs -->

examples/data-sources/astro_api_token/data-source.tf

@@ -1,3 +1,8 @@
 data "astro_api_token" "example" {
   id = "clxm4836f00ql01me3nigmcr6"
+}
+
+# Output the API token value using terraform apply
+output "api_token" {
+  value = data.astro_api_token.example
 }

examples/data-sources/astro_api_tokens/data-source.tf

@@ -10,4 +10,9 @@ data "astro_api_tokens" "workspace_example" {
 
 data "astro_api_tokens" "deployment_example" {
   deployment_id = "clx44jyu001m201m5dzsbexqr"
+}
+
+# Output the API tokens value using terraform apply
+output "api_tokens" {
+  value = data.astro_api_tokens.example
 }

examples/data-sources/astro_cluster/data-source.tf

@@ -1,3 +1,8 @@
 data "astro_cluster" "example" {
   id = "clozc036j01to01jrlgvueo8t"
 }
+
+# Output the cluster value using terraform apply
+output "cluster" {
+  value = data.astro_cluster.example
+}

examples/data-sources/astro_cluster_options/data-source.tf

@@ -6,3 +6,8 @@ data "astro_cluster_options" "example_cluster_options_filter_by_provider" {
   type           = "HYBRID"
   cloud_provider = "AWS"
 }
+
+# Output the cluster options value using terraform apply
+output "cluster_options" {
+  value = data.astro_cluster_options.example_cluster_options
+}

examples/data-sources/astro_clusters/data-source.tf

@@ -6,4 +6,9 @@ data "astro_clusters" "example_clusters_filter_by_names" {
 
 data "astro_clusters" "example_clusters_filter_by_cloud_provider" {
   cloud_provider = "AWS"
+}
+
+# Output the clusters value using terraform apply
+output "clusters" {
+  value = data.astro_clusters.example_clusters
 }

examples/data-sources/astro_deployment/data-source.tf

@@ -1,3 +1,8 @@
 data "astro_deployment" "example" {
   id = "clozc036j01to01jrlgvueo8t"
 }
+
+# Output the deployment value using terraform apply
+output "deployment" {
+  value = data.astro_deployment.example
+}

examples/data-sources/astro_deployment_options/data-source.tf

@@ -15,3 +15,8 @@ data "astro_deployment_options" "example_with_executor_query_param" {
 data "astro_deployment_options" "example_with_cloud_provider_query_param" {
   cloud_provider = "AWS"
 }
+
+# Output the deployment options value using terraform apply
+output "deployment_options" {
+  value = data.astro_deployment_options.example
+}

examples/data-sources/astro_deployments/data-source.tf

@@ -10,4 +10,9 @@ data "astro_deployments" "example_deployments_filter_by_deployment_ids" {
 
 data "astro_deployments" "example_deployments_filter_by_workspace_ids" {
   workspace_ids = ["clozc036j01to01jrlgvu798d"]
+}
+
+# Output the deployments value using terraform apply
+output "deployments" {
+  value = data.astro_deployments.example_deployments
 }

examples/data-sources/astro_organization/data-source.tf

@@ -1 +1,6 @@
 data "astro_organization" "example" {}
+
+# Output the organization value using terraform apply
+output "organization" {
+  value = data.astro_organization.example
+}

examples/data-sources/astro_team/data-source.tf

@@ -1,3 +1,8 @@
 data "astro_team" "example" {
   id = "clwbclrc100bl01ozjj5s4jmq"
+}
+
+# Output the team value using terraform apply
+output "team" {
+  value = data.astro_team.example
 }

examples/data-sources/astro_teams/data-source.tf

@@ -3,3 +3,8 @@ data "astro_teams" "example_teams" {}
 data "astro_teams" "example_teams_filter_by_names" {
   names = ["my first team", "my second team"]
 }
+
+# Output the teams value using terraform apply
+output "example_teams" {
+  value = data.astro_teams.example_teams
+}

examples/data-sources/astro_user/data-source.tf

@@ -1,3 +1,8 @@
 data "astro_user" "example" {
   id = "clhpichn8002m01mqa4ocs7g6"
+}
+
+# Output the user value using terraform apply
+output "user" {
+  value = data.astro_user.example
 }

examples/data-sources/astro_users/data-source.tf

@@ -7,3 +7,8 @@ data "astro_users" "example_users_filter_by_workspace_id" {
 data "astro_users" "example_users_filter_by_deployment_id" {
   deployment_id = "clx44jyu001m201m5dzsbexqr"
 }
+
+# Output the users value using terraform apply
+output "example_users" {
+  value = data.astro_users.example_users
+}

examples/data-sources/astro_workspace/data-source.tf

@@ -1,3 +1,8 @@
 data "astro_workspace" "example" {
   id = "clozc036j01to01jrlgvueo8t"
 }
+
+# Output the workspace value using terraform apply
+output "workspace" {
+  value = data.astro_workspace.example
+}