A continuación se muestran las prácticas recomendadas y recordatorios para administradores de ArcGIS Notebook Server.
Administrar su implementación
Recursos del equipo
Cuando un notebook está en ejecución, el contenedor que ejecuta consume recursos del sitio de ArcGIS Notebook Server. El tiempo de ejecución Standard requiere 1 núcleo de CPU y 4 GB de memoria, mientras que el tiempo de ejecución Advanced requiere 2 núcleos de CPU y 6 GB de memoria. Asegúrese de que el sitio del servidor tenga una capacidad adecuada en su equipo para que pueda asistir a todos los miembros del portal con privilegios de notebook.
Federación
ArcGIS Notebook Server debe estar federado con un portal para funcionar. No es posible tener un sitio de ArcGIS Notebook Server independiente.
No anule la federación de su sitio de ArcGIS Notebook Server a no ser que sea absolutamente necesario. La anulación de la federación de un sitio de ArcGIS Notebook Server tiene consecuencias graves e irreversibles para el contenido y los notebooks de su servidor.
Puertos
Abra y proteja el puerto 11443 de su equipo de ArcGIS Notebook Server. Web Adaptor necesita comunicarse con este puerto, y todo el tráfico debe pasar a través de él.
ArcGIS Notebook Server necesita acceder al puerto 7443 del equipo en el que está alojado el portal de ArcGIS Enterprise con el que está federado. No es necesario que el puerto 7443 esté abierto en el equipo de ArcGIS Notebook Server.
Se crean contenedores de Docker en los puertos 30001-31000 de forma predeterminada. Estos puertos no quedan expuestos fuera del equipo de ArcGIS Notebook Server, y solo ArcGIS Notebook Server necesita comunicarse con dichos puertos.
Redes
El componente de Docker Engine de su sitio de ArcGIS Notebook Server proporciona la red para que el código de los notebooks de ArcGIS pueda acceder a su red. Si experimenta problemas de conectividad de red en un notebook en ejecución, compruebe la red de Docker con la herramienta de comando docker network de la siguiente manera:
- Utilice el comando docker network create para volver a crear su red en caso necesario.
- Si vuelve a crear su red, vuelva a asignarla a los contenedores del sitio mediante el comando docker network connect.
Para ver una lista de todos los contenedores que se ejecutan en su sitio, utilice el comando docker ps -a.
Registros
Puede utilizar los registros de ArcGIS Notebook Server para solucionar los problemas relacionados con la ejecución de notebooks de ArcGIS. Consulte los registros mediante el Directorio de administrador de ArcGIS Notebook Server. Hay varios niveles de registro que puede configurar para ver diferentes tipos de información.
Implementaciones desconectadas con la Autenticación integrada de Windows
Cada vez que un notebook de ArcGIS dibuja un mapa, extrae ArcGIS API for JavaScript 4.10 de una red de distribución de contenido (CDN). En el caso de los entornos sin conexión, se accede a esta CDN desde el portal con el formato de URL https://portal.domain.com/portal/jsapi/jsapi4. En entornos sin conexión en los que el portal usa la Autenticación integrada de Windows (IWA), un problema conocido es que esa IWA bloquea este acceso. Como resultado, los mapas no se dibujan en los notebooks.
Para solucionar este problema, especifique la ruta de CDN con el valor privatePortalURL, tal y como se muestra en estos pasos:
- Si no conoce la privatePortalURL de su portal, inicie sesión en el Directorio de Portal for ArcGIS como miembro del rol de administrador predeterminado en su organización del portal. La dirección URL tiene el formato https://portal.domain.com:7443/arcgis/portaladmin. Haga clic en Sistema > Propiedades. Localice y registre el valor privatePortalURL.
- Mande a sus autores de notebooks que ejecuten esta celda en cada uno de sus notebooks:
from arcgis.widgets import MapView MapView.set_js_cdn("https://<privatePortalURL>:7443/arcgis/jsapi/jsapi4")
Una vez definida esta ruta de CDN, los notebooks de sus autores usarán privatePortalURL para acceder a ArcGIS API for JavaScript al dibujar mapas.
Controlar acceso
Acceso al portal
Controle quién tiene privilegios de notebook en su portal de ArcGIS Enterprise. Cada miembro que crea su primer notebook inicia su propio contenedor de Docker para notebooks. Es una acción importante que utiliza recursos y memoria del equipo servidor.
De forma predeterminada, solo los administradores del portal tienen privilegios para crear y editar notebooks; los publicadores no tienen. Cree uno o varios roles personalizados en el portal para conceder privilegios de notebook a miembros que no sean administradores, pero sea consciente de a quién asigna roles que incluyan estos privilegios.
Acceso al sistema
La carpeta arcgisworkspace creada durante la instalación debe tener un control de acceso estricto. Inicialmente, solo pueden tener acceso el usuario que instaló ArcGIS Notebook Server y los administradores del sistema. Esta carpeta contiene los espacios de trabajo privados de los usuarios; en ellos se almacenan datos a los que no deberían poder acceder otros usuarios. En esta ubicación también se guarda la información de token del portal a la que los contenedores de Docker pueden acceder.
Notebooks compartidos
Al abrir un notebook compartido como administrador, usted tiene privilegios administrativos sobre el notebook, lo que incluye la capacidad de ejecutar todas las celdas. Abra solamente notebooks en cuyo origen confíe y ejecute cada celda solo después de haber revisado su contenido.
Personalizar su implementación
Cambiar la plantilla de notebook predeterminada
ArcGIS Notebook Server incluye una plantilla de notebook predeterminada que aparece cuando se abre un notebook nuevo. Como administrador, puede sobrescribir esta plantilla predeterminada con un archivo de notebook personalizado para su organización.
Para ello, cree el notebook que desea utilizar como plantilla predeterminada de su organización y guárdelo para sobrescribir el notebook de plantilla existente, que se encuentra en <ArcGIS Notebook Server install directory>\framework\etc\ipynb_defaults\default_new.ipynb. El notebook debe tener el nombre default_new.ipynb si se va a utilizar como notebook de plantilla predeterminado de ArcGIS Notebook Server.